Klaviyo Integration

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

ℹ️ Klaviyo Help Center (external resources)

Click here for the OAuth2 installation guide

Step 1: Generate API Keys & Members List

Open Klaviyo, click on your Profile (top right) and then Account from the drop down menu. In the Account page click on Settings in the top right. Scroll down to API Keys.

Public API Key: The first one we need is your Public API Key. You can see Duel's Public API Key above: WM5qPB. Please make note of this key and the following.

Create Private API Key: Your brand will also need to create a Private API Key. You can name this Duel for example.

Members List: The last thing needed from your Klaviyo account is a list where Duel will import contacts. You can either create a new list or if you already have member lists set up, we'd advise using your "Main List".

Navigate to Lists & Segments and ether select a pre exiting or create one. Once selected make a note of the Member list ID in the URL (after list/).

You can see in the screenshot below that the Members list ID for the example "Duel" list is: SNZFP5

Step 2: Setting up Duel

Login to your Duel Dashboard navigate top right into settings and then Klaviyo (if Klaviyo is missing speak to your CSM about getting Klaviyo turned on for your account).

Then head to settings, add a new integration and add in the tokens/member lists we generated in the previous step.

Once they're set up navigate to Event/Properties and switch on all elements that you'd like to receive in Klaviyo (we'd recommend all to start with).

Note You're able to change the targets for each property source if you'd like

Step 3: Test & Syncing Members

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

Then search in Klaviyo profiles for that specific email address in order to check that the Duel parameters are visible.

You can find the Duel parameters in the bottom right of a profile page.

When ready, go back to the member sync tab and click Sync all members. This can take a few minutes.

Step 4: All done! You are now integrated with Klaviyo

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

Setting up OAuth2

Step 1: Creating a Klaviyo Integration

Login to your Duel Dashboard navigate top right into settings and then Klaviyo (if Klaviyo is missing speak to your CSM about getting Klaviyo turned on for your account).

Click "Add CRM Connection"

Step 2: Connect to Klaviyo App

Click "Connect" to authorise the integration. You will be redirected to Klaviyo's OAuth screen. Accept the permissions:

Step 4: Complete the integration

Click "Edit" on your integration, which should now show up in the list on the page you were redirected to and fill out your list ID (if you have one) and define which groups you want to target.

Step 5: Continue the setup:

Continue the setup here