Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. Jobs
  5. Dotmailer Export

Dotmailer Export

markdownView as Markdown

Create and manage data import and export jobs.

DotmailerExport: Create job

POSThttps://api.lytics.io/v2/job/dotmailer-export

Create a DotmailerExport job

Sample Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "address_book_name": "string",
    "address_book_status_field": "string",
    "audience_name": "string",
    "backfill_only": true,
    "collection_id": "string",
    "disable_dedupe": true,
    "email_field": "string",
    "email_type": "Html",
    "exit_action": "string",
    "field_changes": [
      "string"
    ],
    "id_field": "dm_contact_id",
    "insight_fields": [
      "string"
    ],
    "insight_recommendations": true,
    "mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "opt_in_type": "Unknown",
    "recommender_mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "resubscribe": true,
    "resubscribe_no_challenge": true,
    "seg_mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "segment_id": "string",
    "segment_ids": [
      "string"
    ],
    "sync_status": true,
    "trigger_join": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|201 Created
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "address_book_name": "string",
      "address_book_status_field": "string",
      "audience_name": "string",
      "backfill_only": true,
      "collection_id": "string",
      "disable_dedupe": true,
      "email_field": "string",
      "email_type": "Html",
      "exit_action": "string",
      "field_changes": [
        "string"
      ],
      "id_field": "dm_contact_id",
      "insight_fields": [
        "string"
      ],
      "insight_recommendations": true,
      "mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "opt_in_type": "Unknown",
      "recommender_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "resubscribe": true,
      "resubscribe_no_challenge": true,
      "seg_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "segment_id": "string",
      "segment_ids": [
        "string"
      ],
      "sync_status": true,
      "trigger_join": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

DotmailerExport: Get job

GEThttps://api.lytics.io/v2/job/dotmailer-export/{id}

Get the summary of a DotmailerExport job

Sample Response
Status|200 OK
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "address_book_name": "string",
      "address_book_status_field": "string",
      "audience_name": "string",
      "backfill_only": true,
      "collection_id": "string",
      "disable_dedupe": true,
      "email_field": "string",
      "email_type": "Html",
      "exit_action": "string",
      "field_changes": [
        "string"
      ],
      "id_field": "dm_contact_id",
      "insight_fields": [
        "string"
      ],
      "insight_recommendations": true,
      "mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "opt_in_type": "Unknown",
      "recommender_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "resubscribe": true,
      "resubscribe_no_challenge": true,
      "seg_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "segment_id": "string",
      "segment_ids": [
        "string"
      ],
      "sync_status": true,
      "trigger_join": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

DotmailerExport: Update job

PUThttps://api.lytics.io/v2/job/dotmailer-export/{id}

Update a DotmailerExport job

Sample Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "address_book_name": "string",
    "address_book_status_field": "string",
    "audience_name": "string",
    "backfill_only": true,
    "collection_id": "string",
    "disable_dedupe": true,
    "email_field": "string",
    "email_type": "Html",
    "exit_action": "string",
    "field_changes": [
      "string"
    ],
    "id_field": "dm_contact_id",
    "insight_fields": [
      "string"
    ],
    "insight_recommendations": true,
    "mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "opt_in_type": "Unknown",
    "recommender_mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "resubscribe": true,
    "resubscribe_no_challenge": true,
    "seg_mappings": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "segment_id": "string",
    "segment_ids": [
      "string"
    ],
    "sync_status": true,
    "trigger_join": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|200 OK
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "address_book_name": "string",
      "address_book_status_field": "string",
      "audience_name": "string",
      "backfill_only": true,
      "collection_id": "string",
      "disable_dedupe": true,
      "email_field": "string",
      "email_type": "Html",
      "exit_action": "string",
      "field_changes": [
        "string"
      ],
      "id_field": "dm_contact_id",
      "insight_fields": [
        "string"
      ],
      "insight_recommendations": true,
      "mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "opt_in_type": "Unknown",
      "recommender_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "resubscribe": true,
      "resubscribe_no_challenge": true,
      "seg_mappings": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "segment_id": "string",
      "segment_ids": [
        "string"
      ],
      "sync_status": true,
      "trigger_join": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
Hide Parameters

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.address_book_nameoptionalstring

Enter a new address book name to be created in dotdigital. If left blank will default to 'Lytics + audience name' NOTE: this will only be used if the 'Existing Address Book' is left blank

config.address_book_status_fieldoptionalstring

Select the Lytics field that contains the user's dotdigital address book status. Leave blank if this is not an acquisition sync export

config.audience_nameoptionalstring

Choose the address book to add contacts to. If you want to create a new address book enter the name in the 'New Address Book Name' field below

config.backfill_onlyoptionalboolean

Select this to do a one time export of the audience

config.collection_idoptionalstring

Content collection to include recommendations from - if not selected, no recommendations are sent to dotdigital

config.disable_dedupeoptionalboolean

Selecting this will disable deduplication of events

config.email_fieldoptionalstring

Field that contains the contact's email

config.email_typeoptionalstring

The type of emails these contacts can receive

config.exit_actionoptionalstring

The action to take when an entity exits the audience. Note: Unsubscribing will significantly increase API usage

config.field_changesoptionalstring[]

Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected fields get an update, then the user will be updated in dotdigital

config.id_fieldoptionalstring

Field that contains the contact's dotdigital ID. This may be a map field if importing users from multiple accounts

config.insight_fieldsoptionalstring[]

Select the Lytics user fields you would like to send to the lytics_fields insight collection in dotdigital. Insight data supports complex data types like arrays and maps

config.insight_recommendationsoptionalboolean

Select to add content recommendations for users to the lytics_recommendations insight collection in dotdigital

config.mappingsoptionalobject[]

Map Lytics fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields

config.opt_in_typeoptionalstring

Opt-in type for the contacts that will be created; see [dotdigital documentation](https://support.dotdigital.com/hc/en-gb/articles/212212098-Explaining-contact-opt-in-types) for details

config.recommender_mappingsoptionalobject[]

Map content recommendation fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields

config.resubscribeoptionalboolean

Contacts will be resubscribed to address books. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level

config.resubscribe_no_challengeoptionalboolean

Contacts will be resubscribed to address books without triggering a confirmation email. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level

config.seg_mappingsoptionalobject[]

Map all Lytics Audiences to dotdigital address books by selecting the Lytics audience on the left, and its dotdigital destination on the right

config.segment_idoptionalstring

Choose the audience of users to export to dotdigital

config.segment_idsoptionalstring[]

Which Lytics Audience(s) to export to dotdigital

config.sync_statusoptionalboolean

Select to update user status in lytics immediately, this will add events to the dotmailer_export_status stream. Note: this can cause feedback loops that can cause poor performance

config.trigger_joinoptionalboolean

Contacts will trigger join actions when added to the address book. Note: this will significantly increase API usage

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring
Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.address_book_nameoptionalstring

Enter a new address book name to be created in dotdigital. If left blank will default to 'Lytics + audience name' NOTE: this will only be used if the 'Existing Address Book' is left blank

config.address_book_status_fieldoptionalstring

Select the Lytics field that contains the user's dotdigital address book status. Leave blank if this is not an acquisition sync export

config.audience_nameoptionalstring

Choose the address book to add contacts to. If you want to create a new address book enter the name in the 'New Address Book Name' field below

config.backfill_onlyoptionalboolean

Select this to do a one time export of the audience

config.collection_idoptionalstring

Content collection to include recommendations from - if not selected, no recommendations are sent to dotdigital

config.disable_dedupeoptionalboolean

Selecting this will disable deduplication of events

config.email_fieldoptionalstring

Field that contains the contact's email

config.email_typeoptionalstring

The type of emails these contacts can receive

config.exit_actionoptionalstring

The action to take when an entity exits the audience. Note: Unsubscribing will significantly increase API usage

config.field_changesoptionalstring[]

Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected fields get an update, then the user will be updated in dotdigital

config.id_fieldoptionalstring

Field that contains the contact's dotdigital ID. This may be a map field if importing users from multiple accounts

config.insight_fieldsoptionalstring[]

Select the Lytics user fields you would like to send to the lytics_fields insight collection in dotdigital. Insight data supports complex data types like arrays and maps

config.insight_recommendationsoptionalboolean

Select to add content recommendations for users to the lytics_recommendations insight collection in dotdigital

config.mappingsoptionalobject[]

Map Lytics fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields

config.opt_in_typeoptionalstring

Opt-in type for the contacts that will be created; see [dotdigital documentation](https://support.dotdigital.com/hc/en-gb/articles/212212098-Explaining-contact-opt-in-types) for details

config.recommender_mappingsoptionalobject[]

Map content recommendation fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields

config.resubscribeoptionalboolean

Contacts will be resubscribed to address books. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level

config.resubscribe_no_challengeoptionalboolean

Contacts will be resubscribed to address books without triggering a confirmation email. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level

config.seg_mappingsoptionalobject[]

Map all Lytics Audiences to dotdigital address books by selecting the Lytics audience on the left, and its dotdigital destination on the right

config.segment_idoptionalstring

Choose the audience of users to export to dotdigital

config.segment_idsoptionalstring[]

Which Lytics Audience(s) to export to dotdigital

config.sync_statusoptionalboolean

Select to update user status in lytics immediately, this will add events to the dotmailer_export_status stream. Note: this can cause feedback loops that can cause poor performance

config.trigger_joinoptionalboolean

Contacts will trigger join actions when added to the address book. Note: this will significantly increase API usage

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring