Dotdigital Integration

Step-by-step guide for brands to complete the Duel x Dotdigital integration.

⚠️ Before you begin this integration be sure to let us know so we can enable the Dotdigital CRM integration on your Duel account


ℹ️ Dotdigital Help Center (external resources)

Step 1: Connect Duel to Dotdigital

The operator will need to authenticate/configure within the Dotdigital settings area.

Screenshot 2023-01-04 at 14.05.55

Step 2: Create an API user & Address Book ID

Open Dotdigital to create an API user. Navigate to Settings (three dots at the bottom left corner) > Access:

Screenshot 2023-01-04 at 18.01.33


Once at the Access menu, click on API users and select NEW USER to create an API managed user. 

Screenshot 2023-01-04 at 14.06.46

The username (email address) is automatically generated for you and must not be edited.

You can also add a description (optional) and you must create a password and confirm it.

Then select Enabled and click save:


Screenshot 2023-01-04 at 18.37.23


Open Dotdigital to create an Address book ID. Navigate to Contacts > All Contacts:

Screenshot 2023-01-05 at 17.03.02

Then create a New Address Book and give it a name, e.g. Duel and click SAVE

Screenshot 2023-01-05 at 17.03.42

Copy the Address Book ID from the URL - it's a set of numbers like the one highlighted below.

Screenshot 2023-01-05 at 17.18.56


Step 3: Add new API user & Address Book ID to Duel

Open the Duel app and head to Settings in the top right, followed by Dotdigital. You will then need to open up the Settings sub-tab. From here, you can paste your API user email, password and Adress book ID into the relevant fields and click SAVE.


Screenshot 2023-01-04 at 14.06.04

Step 4: Enable Duel’s events & properties

Within the Dotdigital section of the Duel app, head to Events/Properties and switch on all elements that you’d like sent over to Dotdigital.

We recommend enabling all to start with, so as to capture as much data as possible.

Screenshot 2023-01-05 at 17.51.58

NOTE: You are able to change/edit the Target names for each property source if you would like to. 


Step 5: Test Member Syncing

Then we can test the integration by syncing a single member from the Duel platform by entering their email address under Dotdigital Member sync and then clicking the Sync test member button (this needs to be an actual member of the programme). 

Screenshot 2023-01-05 at 18.10.07

Head back into Dotdigital, go to Contacts > All contacts > Address books and search for the email address of your test member in the recently created Duel address book.


Screenshot 2023-01-05 at 18.12.21

Click on the email address of your test member and then head into Contacts > Data fields and you'll be able to take a look at their contact details with all of the synced Duel events & properties.

Screenshot 2023-01-05 at 18.19.01

Step 6: All members syncing

If the test member & information has synced correctly, you can head back to the Duel app and click Sync all members under Member sync

Screenshot 2023-01-05 at 18.27.09

🕑 Note that this process can take a few minutes to complete


Once all members have been synced, the total number should appear as below:


Screenshot 2023-01-05 at 18.32.00

If you head back to Dotdigital, you'll be able to find all synced contact records under Contacts > All contacts > Duel Address book.

Screenshot 2023-01-05 at 18.35.30

Step 7: Test the integration

As members signup to the Program and submit tasks through the Duel portal, these will appear in Dotdigital.

Select the member you want to look into under Contacts > Data fields and then head into Insight data. You'll be able to see that member's Duel Activity using the highlighted dropdown menu with different Duel events & properties.


Screenshot 2023-01-05 at 18.51.55

Step 8: All done! You are now integrated with Dotdigital

Now it's time to set up some epic flows to help really build that community!