Adestra

Documentation Index

Fetch the complete documentation index at: https://docs.permutive.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Adestra

Adestra enables publishers to deliver personalized email campaigns and newsletters using audience segmentation and analytics.

​

Overview

• Destination: Permutive sends cohort memberships to Adestra, where they are represented as Contact lists. These lists can be used to trigger automated email campaigns or target users in marketing workflows.

• Send Permutive cohorts to Adestra to trigger automated email campaigns when users enter a cohort
• Use behavioral and demographic cohorts for personalized email experiences
• Leverage Permutive’s first-party data for email targeting and segmentation
• Create timely, relevant email campaigns based on real-time user actions and cohort membership

​

Environment Compatibility

​

Prerequisites

• Adestra Account - You must have an active Adestra account with API access enabled.
• Adestra API Key - You will need your Adestra API key to configure the integration in the Permutive dashboard. This key should have permissions to manage contacts and lists.
• Adestra Contact Lists - You must create Contact lists in Adestra ahead of time. The integration will add and remove users from these pre-existing lists based on cohort membership, but it will not automatically create new lists.
• Contact ID Configuration - You must configure Permutive to collect Adestra Contact IDs (Adestra’s internal user identifier) and pass them to Permutive via identity management. The identity type must match the “Alias tag” configured in the Permutive dashboard.
• Identity Management Setup - You need to implement identity management to associate Permutive users with Adestra Contact IDs. This is typically done using the Permutive Identify API or SDK identify methods.

​

Setup

permutive.identify([
  {
    id: "12345", // Adestra Contact ID
    tag: "adestra", // Must match the Alias tag from Step 2
    priority: 0
  }
]);

curl -XPOST https://api.permutive.com/v2.0/identify \
  -H 'X-API-Key: <PUBLIC_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": "<PERMUTIVE_ID>",
    "aliases": [
      {
        "id": "<ADESTRA_CONTACT_ID>",
        "tag": "adestra",
        "priority": 0
      }
    ]
  }'

// Identify users with their Adestra Contact ID
permutive.identify([
  {
    id: "12345", // Adestra Contact ID
    tag: "adestra", // Must match the Alias tag configured in dashboard
    priority: 0
  }
]);

// Identify users with their Adestra Contact ID
Permutive.shared.identify(
  identifiers: [
    Identifier(
      id: "12345", // Adestra Contact ID
      tag: "adestra", // Must match the Alias tag configured in dashboard
      priority: 0
    )
  ]
)

// Identify users with their Adestra Contact ID
Permutive.getInstance().identify(
  listOf(
    Identifier(
      id = "12345", // Adestra Contact ID
      tag = "adestra", // Must match the Alias tag configured in dashboard
      priority = 0
    )
  )
)

curl -XPOST https://api.permutive.com/v2.0/identify \
  -H 'X-API-Key: <PUBLIC_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": "<PERMUTIVE_ID>",
    "aliases": [
      {
        "id": "<ADESTRA_CONTACT_ID>",
        "tag": "adestra",
        "priority": 0
      }
    ]
  }'

​

Data Types

​

Troubleshooting

​

Changelog