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 workflow 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 and configure a removal of contacts in Dotdigital.

  1. Navigate to the Integrations page and select the Dotdigital tile. Dotdigital Logo
  2. Select Workflows from the menu on the left.
  3. Select Remove 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 the 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 Address-book Status Field drop-down, select the field that contains the contact's address-book statuses.
  9. From the One Time checkbox, select this to do a one-time removal of the users in the audience.
  10. Click on the Show Advanced Options tab to expand the advanced configuration.
  11. From the Enter Action drop-down, select the action to take when a contact enters the audience. Note: removing may significantly increase API usage.
  12. From the Exit Action drop-down, select the action to take when a contact exits the audience.
  13. From the Resubscribe With No Challenge checkbox, select this to suppress Dotdigital's challenge email when the user is resubscribed, if possible.
  14. Select the Sync Status checkbox to update the contact's address book status in Lytics.
  15. From the Opt-in Type drop-down, select the opt-in type for the contacts that will be created. See the Dotdigital documentation for details.
  16. From the Email Type drop-down, select the type of emails these contacts can receive.
  17. With 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: Complex fields such as arrays and maps are not supported by Dotdigital.
  18. In the Work Tracking Slug box, enter a slug to use to track the work. This slug should be unique.
  19. Click the Start Export button to start the work.

Dotdigital Remove Contacts Workflow