Emarsys Integration

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

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


ℹ️ Emarsys Help Center (external resources)

Step 1: Create an API user & secret

Open Emarsys and navigate to Management > Security Settings:


Screenshot 2022-12-07 at 14.35.43

From here, navigate to API users, and create a new API user:


Screenshot 2022-12-07 at 14.37.02

You will need to enter your Emarsys password in order to create a new API user:


Screenshot 2022-12-07 at 14.38.29


Once the new API user has been created, you will be given a User name & Secret API key:


Screenshot 2022-12-07 at 14.39.23

Step 2: Add new API user & secret to Duel

Open the Duel app and head to Settings in the top right, followed by Emarsys. You will then need to open up the Settings sub-tab. From here, you can paste your API user username and API user secret keys into the relevant fields.


Screenshot 2022-12-07 at 14.33.00

Step 3: Edit required permissions list

Within Duel’s Emarsys settings, you will notice there is a list of required permissions. This will need to be edited in Emarsys.

Head back to Emarsys, within Security Settings - API users (where you left off).

Click the Edit button on the very right of your newest API user.

Screenshot 2022-12-07 at 14.44.17


You will then need to scroll through the API user settings and toggle ON all of the required permissions that were listed in Duel and hit Edit at the very bottom, once done.


Screenshot 2022-12-07 at 14.46.56

Emarsys can take a long time to update the permissions list, so we recommend you wait for 10 minutes for the Save to work correctly

Head back to the Duel app and click save on your settings.

Step 4: Enable Duel’s events & properties

Within the Emarsys section of the Duel app, head to “Events/Properties” and switch on all elements that you’d like sent over to Emarsys. We recommend enabling all, so as to capture as much data as possible.

Screenshot 2021-09-10 at 10.39.42


PLEASE NOTE: You are able to change the Targets for each source if you would like to. 


Step 5: Sync test member

Within the Emarsys section of the Duel app, head to “Member sync”, type in the email address of one of your test members & press “Sync test member”. After a very short wait, you will notice the member’s information display as below:


Screenshot 2022-12-07 at 14.49.41

Head back into Emarsys, and search for the email address of your test member using the search scope: Contacts by Email.

Screenshot 2022-12-07 at 16.05.03

Using the search result for your test member, you can create a new contact list by clicking “Save Contact List” in the top right. Give your new contact list a name e.g. “Duel members”.


Screenshot 2022-12-07 at 16.06.33

Step 6: Linking new contact list to Duel

Within the URL of your new list, you will see an ID number. It will look like this:


Highlight the list ID and Ctrl/Command + C to copy.


Screenshot 2022-12-07 at 14.29.55

And paste it within Duel’s Emarsys settings before clicking SAVE.

Screenshot 2022-12-07 at 16.09.45

Step 7: Sync all members

Take a look at the contact details for your test member via your new contact list in Emarsys, you will see that all of the synced Duel events & properties will be displayed under “Other”.


Screenshot 2022-12-07 at 14.52.10

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


Screenshot 2022-12-07 at 16.10.25

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

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