Dotdigital Installation Instructions

Before you Begin

Before you begin, you will need to obtain authentication information from Dotdigital.

Steps to Obtain the Credentials from Dotdigital:

Go to your Dotdigital URL, for example, https://r2-app.dotdigital.com/default.aspx and log in with your Dotdigital account credentials.
On the Dotdigital Home page, choose your account and then click Settings.
On the Settings page, click Access > API users.
Dotdigital displays the API users page, which shows your API endpoint and a list of current users.
Make note of your API endpoint.
Click Add New API User.
Dotdigital assigns the user an email address. Enter a Description for the account, such as "testing", and a Password.
Save the email address and password. You will use them when installing the integration.
Select the Rate limiting type according to your account agreement.
Click Save to create the new user.

Authentication with Dotdigital

Integration with Dotdigital serves a specific purpose: it handles user login authorization only. This means:

For API calls: Basic Authentication is still required using API user credentials.

Installing the Dotdigital Integration

Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Dotdigital Integration title.
Click the Subscribe button.
Enter the name of the subscription and select a version. It can be set to any relevant and unique subscription name within the company where this subscription is created.
Enter the API URL endpoint for your Dotdigital instance that you saved when creating a user.
Enter the API User and the API Password provided when you created a new user in Dotdigital.
Enter the Integration Token. This token is not displayed in your Dotdigital account. To get an integration token, you'll need to go through Dotdigital's partner program application and verification process. Integration tokens are issued directly by the Dotdigital Partner Engineering team once you begin the verification process to become a verified integration partner.
Enter the API Throttle Limit. This setting prevents any single integration or user from overwhelming the system with too many requests. It protects system performance by controlling the number of API requests that can run simultaneously, ensuring fair usage.
- Recommended Values
  - Initial Setup: 5
  - Ongoing Operations: 500
  - High Volume: 500
Enter the API Throttle Seconds. This defines the time window during which the API Throttle Limit is measured. If an integration makes too many requests within this time window, additional requests are rejected until the window resets.
- Default Value: 60 seconds
- Range: 60 seconds
Enter the number of Concurrent Connections. This specifies the maximum number of simultaneous API connections that Dotdigital can process for a user or integration. If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
- Default Value: 5
- Range: 10
Enter the number of Concurrent Batch Executions. This specifies the maximum number of simultaneous batch executions that can process for an integration at one time. If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
- Default Value: 5
- Range: 10
Click Apply to save the settings.