To enable Dotdigital to track the usage of verified partner integrations, you must include a unique integration token with each call to our APIs made by the integration.

Our Partner Engineering team issues you with a unique integration token when you start the verification process.

Learn more in Become a verified integration partner.

Benefits

Once verified, your integration is listed within the Dotdigital platform in the Connect area. This means that it’s discoverable to all Dotdigital users in our integrations catalog, and for any mutual customers using it, your integration shown as an installed integration. This gives the mutual customer visibility of the integration and provides a way of linking back to your platform from within Dotdigital.

You also receive a listing on our Partner directory, with a Verified badge to show your integration’s status.

To have a verified integration you must be a Dotdigital technology partner. To join our partner program, apply here. You can also view our Partner directory.

Implement tracking

You just need to ensure that you include the custom HTTP header x-ddg-integration-token with a value of your integration’s unique integration token, on all API calls made by your integration to Dotdigital.

For example:

GET /v2/account-info HTTP/1.1
Accept: application/json
Authorization: Basic dGVzdDpwYXNzd29yZA==
x-ddg-integration-token: fbb52167-e624-4f19-ae46-7db9fa808fcc
Host: r1-api.dotdigital.com

As your integration makes calls to Dotdigital's API, we detect the x-ddg-integration-token HTTP header and use this to record a mutual customer using your integration.

If we don’t see any API calls from your integration for a mutual customer for a period of 30 days, then we assume they're no longer using the integration.