Dotdigital Destination
Dotdigital is an all-in-one customer experience and data platform (CXDP) that empowers marketing teams to exceed customer expectations with highly personalized cross-channel journeys.
This destination is maintained by Dotdigital. For any issues with the destination, contact the Dotdigital Support team.
Getting started
- From your workspace’s Destination catalog page search for “Dotdigital”.
- Select Dotdigital and click Add Destination.
- Select an existing Source to connect to Dotdigital (Actions).
- Log in to your Dotdigital account. Expand the User menu in the bottom left and go to Settings > Access > API users.
- Note your API region (r1, r2 or r3) for step 7.
- Create a new API user.
- In Segment, select your Dotdigital account region and paste the API user and API password in the Dotdigital destination settings.
Destination Settings
Setting | Description |
---|---|
Region | Required. The region your account is in |
Password | Required. Your Dotdigital password. |
Username | Required. Your Dotdigital username |
Available Actions
Build your own Mappings. Combine supported triggers with the following Dotdigital-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Enrol Contact to Program
Creates a program enrolment.
Enrol Contact to Program is a Cloud action. The default Trigger is: type = "track" and event = "Enrol Contact to Program"
Field | Description |
---|---|
Contact Identifier type* | Type: STRING Select the field to identify contacts. |
Email Address | Type: STRING The Contact’s email address. |
Mobile Number | Type: STRING The Contact’s mobile number. |
Program* | Type: STRING List of active programs |
Remove Contact from List
Removes a Contact from a List.
Remove Contact from List is a Cloud action. The default Trigger is: type = "track" and event = "Remove Contact from List"
Field | Description |
---|---|
Contact Identifier type* | Type: STRING Select the field to identify contacts. |
Email Address | Type: STRING The Contact’s email address. |
Mobile Number | Type: STRING The Contact’s mobile number. |
List* | Type: NUMBER The List to remove the Contact from. |
Add Contact to List
Adds a contact to a list.
Add Contact to List is a Cloud action. The default Trigger is: type = "track" and event = "Add Contact to List"
Field | Description |
---|---|
Contact Identifier type* | Type: STRING Select the field to identify contacts. |
Email Address | Type: STRING The Contact’s email address. |
Mobile Number | Type: STRING The Contact’s mobile number. |
List* | Type: NUMBER The list to add the contact to. |
Data Fields | Type: OBJECT An object containing key/value pairs for data fields assigned to this Contact. Custom Data Fields must already be defined in Dotdigital. |
Send Transactional SMS
Sends a transactional SMS.
Send Transactional SMS is a Cloud action. The default Trigger is: type = "track" and event = "Send Transactional SMS"
Field | Description |
---|---|
To* | Type: STRING Only valid mobile numbers with an international dialling prefix will be accepted (e.g. 447777123123). |
From | Type: STRING Enter a custom From name, or leave blank to use a random number. From name format varies by region. Learn more |
Message* | Type: TEXT The content of the SMS, up to 160 non-encoded characters per message. |
Link Shortening | Type: BOOLEAN Link shortening will automatically shorten your links to save character count and track who clicked on them for better reporting. Defaults to No. |
Allow Unicode Characters | Type: BOOLEAN If Yes, Unicode characters will be allowed in the message body. If No, any messages containing Unicode will not be sent. Please read why Unicode is important before switching this on. Defaults to No. |
Send Email Campaign
Sends a marketing email to a contact.
Send Email Campaign is a Cloud action. The default Trigger is: type = "track" and event = "Send Email Campaign"
Field | Description |
---|---|
Email* | Type: STRING A single email address to send the campaign to. If the contact does not exist in your Dotdigital account, the campaign won’t be sent. |
Campaign* | Type: NUMBER The campaign to email to a contact. |
Send Date | Type: DATETIME The campaign will be sent immediately if the send date is left blank. |
Send Time Optimised | Type: BOOLEAN Send the campaign at the most appropriate time based upon their previous opens. |
Send Transactional Email
Sends a transactional email.
Send Transactional Email is a Cloud action. The default Trigger is: type = "track" and event = "Send Transactional Email"
Field | Description |
---|---|
From Address* | Type: STRING Use either your default transactional email from address, or another custom from address you have added to your account. If you set a from address that is not listed in your available from addresses, Dotdigital will replace it with your default from address. You may set a from name as well as an email address, for example “My Company < |
To Address* | Type: STRING The email address(es) to send to. |
Subject* | Type: STRING The subject line for your email. |
HTML Content* | Type: TEXT The HTML content for your email. |
Plain Text Content | Type: TEXT The plain text content for your email. |
CC Addresses | Type: STRING The CC email address(es) to send to. Separate email addresses with a comma. Maximum: 100. |
BCC Addresses | Type: STRING The BCC email address(es) to send to. Separate email addresses with a comma. Maximum: 100. |
Send SMS
Sends a marketing SMS to a contact.
Send SMS is a Cloud action. The default Trigger is: type = "track" and event = "Send SMS"
Field | Description |
---|---|
To* | Type: STRING The mobile number of the contact in E.164 format (e.g. 14155552671). |
Message* | Type: TEXT The message to send in the SMS. |
Additional context
Add Contact to List
Before using the Add Context to List Action, complete the following prerequisites:
- Lists: Create a contact list in Dotdigital. After you’ve created a list in Dotdigital, return to the Segment app and select your list from the dropdown in the Segment event mapping.
- Data Fields: Create or edit your data fields in Dotdigital, then return to the Segment app, open the event mapping, and map Segment properties to Dotdigital data fields.
Enroll Contact to Program
When you use the Enroll Contact to Program action, Dotdigital creates a contact for the identifier you provide, if the contact doesn’t already exist.
Send SMS
Only valid mobile numbers with an international dialing prefix in E.164 format will be accepted. This format is a combination of +[country code][phone number]
. For example: +12133734253
.
Send Transactional SMS
- Only valid mobile numbers with an international dialing prefix in E.164 format will be accepted. This format is a combination of
+[country code][phone number]
. For example:+12133734253
. - You must have SMS pay-as-you-go enabled to use this action. Learn more about how to enable SMS pay-as-you-go in Dotdigital’s documentation.
Engage
You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.
For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true
. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Engage sets that value to false
.
When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.
Real-time to batch destination sync frequency
Real-time audience syncs to Dotdigital may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
Setting | Description |
---|---|
Region (required) |
select , defaults to .The region your account is in |
Password (required) |
password , has no default value. Your Dotdigital password. |
Username (required) |
string , has no default value. Your Dotdigital username |
This page was last modified: 29 Jul 2025
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!