Dotdigital Destination

Destination Info

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

  1. From your workspace’s Destination catalog page search for “Dotdigital”.
  2. Select Dotdigital and click Add Destination.
  3. Select an existing Source to connect to Dotdigital (Actions).
  4. Log in to your Dotdigital account. Expand the User menu in the bottom left and go to Settings > Access > API users.
  5. Note your API region (r1, r2 or r3) for step 7.
  6. Create a new API user.
  7. 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"

Click to show / hide fields

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"

Click to show / hide fields

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"

Click to show / hide fields

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"

Click to show / hide fields

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"

Click to show / hide fields

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"

Click to show / hide fields

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 <Dotmailer123@r1.dotdigital-email.com>”. Read more about using transactional email.

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"

Click to show / hide fields

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:

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



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account