Documentation / Product / Integrations / Dotdigital

Dotdigital: Remove Contacts

Remove or unsubscribe users that enter the configured audience in your Dotdigital account. Optionally you can resubscribe users when they exit the audience, which can be useful for building an audience that has opted out of communications.

Integration Details

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

  1. Request the Dotdigital account information.
  2. For each user entering the Lytics audience, one of three actions can be selected:

  3. For each user exiting the Lytics audience:

  4. Update the user's Dotdigital status via the dotmailer_export_status stream if Sync Status is selected.


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
map(account_id, account_status)dm_account_statusStatus by Dotmailer Account IDmap[string]string
map(join(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 an export Remove Contacts job for dotdigital. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Dotdigital from the list of providers.
  2. Select the Remove Contacts job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to export (if applicable).
  7. Select the Email Field that contains the contact's email.
  8. Select the ID Field that contains the contact's Dotdigital ID.
  9. Select the Address-book Status Field that contains the contact's address-book statuses.
  10. Select One Time to do a one-time removal of the users in the audience.
  11. Select the Enter Action to take when a contact enters the audience. Note: removing may significantly increase API usage.
  12. Select the Exit Action to take when a contact exits the audience.
  13. (Optional) Toggle Show Advanced Options.
    1. Select Resubscribe With No Challenge to suppress Dotdigital's challenge email when the user is resubscribed, if possible.
    2. Select Sync Status to update the contact's address book status in Lytics.
    3. Select the Opt-in Type for the contacts that will be created. See the Dotdigital documentation for details.
    4. Select the Email Type of emails these contacts can receive.
    5. Select the Map Fields to map all the fields from Lytics to Dotdigital 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 Dotdigital.
    6. Enter a Work Tracking Slug to track the work. This slug should be a unique value.
  14. Click Start Job.

Dotdigital Remove Contacts Workflow