Integrate iPaaS.com with Dotdigital to synchronize contacts, order activity, and loyalty certificates, keeping your Dotdigital marketing data aligned with the records in iPaaS.com.
How to Connect
To connect Dotdigital with iPaaS.com, you authenticate with a Dotdigital API user (an email-style username and password). Follow the steps below to gather the required credentials and configure the integration.
Prerequisites
Before setting up the Dotdigital integration in iPaaS.com, ensure you have the following:
A Dotdigital account with access to the Settings area, so you can create an API user.
A Dotdigital API user (username and password). Dotdigital generates the username as an email-style address when you create the user.
Your Dotdigital API endpoint, shown on the Dotdigital API users page. Dotdigital assigns each account to a regional endpoint, so confirm the value for your account rather than assuming a region.
For details on creating an API user, see the Dotdigital documentation at https://developer.dotdigital.com/docs/getting-started-with-the-api.
Configuration Details
Each value you provide when configuring the subscription:
API User: The Dotdigital API user's username (an email-style address assigned by Dotdigital when the API user is created). Find it on the Dotdigital API users page under Settings → Access → API users. Example: apiuser-xxxxxxxxxxxx@apiconnector.com.
API Password: The password set for that API user when it was created in Dotdigital.
Collection Name: The name of the Dotdigital insight-data collection that order (transaction) data is written to. Leave it blank to use the default name Purchases, or enter a different collection name to suit your account.
Configure Subscription Settings
Navigate to the Dotdigital subscription settings in iPaaS.com and provide the following information:
Field | Description | Required | Example |
Name | A unique name for the subscription. | Yes | Dotdigital Integration |
Version | The integration version to use. | Yes | v1.0 |
API User | The Dotdigital API user's username, used to authenticate API calls. | Yes | |
API Password | The password for the Dotdigital API user. | Yes | (your API user password) |
Collection Name | The Dotdigital insight-data collection that order data is written to. Defaults to Purchases when left blank. | No | Purchases |
Authentication Methods
The integration authenticates to Dotdigital using HTTP Basic authentication with the API user credentials. iPaaS.com sends the API User and API Password with each request to the Dotdigital API.
In Dotdigital, go to Settings → Access → API users.
Click Add New API User. Dotdigital assigns the user an email-style username; enter a Description and a Password.
Select the Rate limiting option that matches your account agreement, then click Save.
Note the API user's username, the password you set, and the API endpoint shown on the API users page.
In the iPaaS.com Dotdigital subscription settings, enter the API User and API Password, then save the subscription to finalize the connection.
Ensure the API user has permission to access the Contacts, insight data, and triggered campaign areas of the Dotdigital API, since the integration uses all three.
Initialization Support
Currently, initialization is not supported for Dotdigital in iPaaS.com. All data synchronization and mappings must be configured manually during the integration process. To load a large set of existing records, subscribers or their MiSP can use the bulk sync using Postman approach.
Throttling
Throttling ensures that Dotdigital's API isn't overwhelmed by excessive API calls, preserving system performance during heavy data transfers.
While the throttling fields are required, the values are pre-populated by the integration settings. For more details, refer to Subscription Configuration – Edit.