Documentation / Product / Integrations / Dotdigital

Dotdigital: Export Modified Contacts

Use the Export Modified Contacts workflow to keep your contacts' data fields up to date in Dotdigital.

Integration Details

This integration utilizes the Dotdigital APIs to send user data. Once the export is started the workflow will:

  1. Scan user profiles in the selected audience.
  2. Convert user profiles to Dotdigital contacts.
  3. Upload batches of contacts (up to 5000 contacts per batch) to Dotdigital.
  4. Sleep until the next scheduled export.


The following fields are included in the default mapping of the dotmailer_export_status stream:

NOTE: Dotmailer rebranded to Dotdigital in January 2019. Due to backwards compatiblity issues old field and stream names still use dotmailer.

Source FieldLytics User FieldDescriptionType
emailemail unique idEmailstring
account_id, account_statusdm_account_statusStatus by Dotmailer Account IDmap[string]string
account_id, address_book_id, address_book_statusdm_addressbook_statusStatus by Dotmailer Addressbook IDmap[string]string
epochms()dm_addressbook_status_tsDate of Last Dotmailer Addressbook Status Updatedate


Follow these steps to set up and configure an export of modified contacts from Dotdigital into Lytics.

  1. Navigate to the Integrations page and select the Dotdigital tile. Dotdigital Logo
  2. Select Workflows from the menu on the left.
  3. Select Export Modified Contacts from the list of workflows.
  4. Select the Authorization you would like to use.
  5. From the Audience drop-down, select the audience of users to remove from Dotdigital.
  6. From the Email Field drop-down, select field that contains the contact's email.
  7. From the ID Field drop-down, select the field that contains the contact's Dotdigital ID.
  8. From the Modified Field drop-down, select the field that contains the last modified time.
  9. Click on the Show Advanced Options tab to expand the advanced configuration.
  10. From the Opt-in Type drop-down, select the opt-in type for the contacts that will be created. See Dotdigital's documentation for details.
  11. From the Email Type drop-down, select the type of emails these contacts can receive.
  12. From the Map Fields input, map all the fields from Lytics to Dotdigital by selecting the Lytics field on the left, and its Dotdigital destination on the right. NOTE: Non scalar fields such as arrays and maps are not supported by Dotdigital.
  13. Select the Keep Updated checkbox to run this export repeatedly.
  14. From the File Export Frequency drop-down, select how often a continuous export should export a new file. The default is daily.
  15. From the Time of Day drop-down, select what time of day a daily, weekly, or monthly export should export. The default is midnight.
  16. From the Timezone drop-down, select the timezone for the time of day.
  17. From the Work Tracking Slug text input, enter a slug to use to track the work. This slug should be unique.
  18. Click the Start Export button to start the export.

Dotdigital Export Modified Contacts Workflow