dotdigital connector icon

dotdigital Connector

Build in-app marketing automations that sync contacts, run campaigns, send transactional messages and surface delivery events. Deliver white‑label dotdigital workflows to customers without shipping custom integration code.

01

Faster time to market

Embed dotdigital without building connector infrastructure.

02

Per-tenant credentials

Store each customer’s API user and region securely.

03

Orchestrate complex flows

Chain contacts, segments, campaigns and webhooks reliably.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

What you can integrate and automate

Teams can connect their app to dotdigital to create and manage contacts and lists, trigger campaigns and transactional sends, run automation programs, and subscribe to delivery and engagement webhooks. Use Cyclr to orchestrate multi-step workflows that move contacts, update segments, start campaigns and handle webhook events across many customer accounts. (community.cyclr.com)

PRODUCT USE CASES

Use cases — what teams build with this connector

Publish white‑label dotdigital automations to your product’s marketplace. Build flows that add users to lists, trigger email or SMS campaigns, sync contact fields and surface webhook delivery events to update your app’s records. Manage per-customer credentials and region endpoints when provisioning accounts. (community.cyclr.com)

Automatically add new users to dotdigital lists

When a new customer account or user is created in your app, create or update a contact and add it to a dotdigital list to start onboarding journeys (Contacts, Lists, Campaigns). (marketing.developer.dotdigital.com)

Send targeted campaigns from product events

Trigger a dotdigital campaign or transactional message when an in-app event occurs, passing contact metadata and tracking identifiers for reporting. (Campaigns, Marketing emails, Transactional sends). (marketing.developer.dotdigital.com)

Keep contact data in sync

Sync contact field updates and subscription status between your app and dotdigital lists to maintain consistent segments and preferences. (Contacts, Contact data fields, Unsubscribe). (marketing.developer.dotdigital.com)},{

ORCHESTRATION

How dotdigital works with Cyclr

Cyclr sits between your SaaS product and dotdigital to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    dotdigital

    dotdigital processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore dotdigital methods you can orchestrate through Cyclr.

Contacts (Email)8

Create Contact with Consent and Preferences

Action

Creates or updates a contact including consent data and marketing preferences.

Get Contact By Email

Action

Gets a contact by email address.

List New Contacts

Action

List all contacts created since the last successful run.

Delete Contact

Action

Deletes a contact by ID.

Update Contact with Consent and Preferences

Action

Updates a contact by ID.

Get Contact with Consent

Action

Gets a contact with their consent information by email address.

List Modified Contacts

Action

List all contacts modified since the last successful run.

List Contacts

Action

Gets a full list of contacts.

Campaigns5

List Campaigns

Action

List all campaigns.

List Campaign Clicks

Action

List all clicks for a campaign since the last successful run.

Send Time Optimised Campaign

Action

Send a time optimised campaign.

Send Campaign

Action

Send a campaign.

List Campaign Opens

Action

List all opens for a campaign since the last successful run.

Address Books8

Update Address Book

Action

Updates an address book.

Create Address Book

Action

Creates an address book.

List Public Address Books

Action

List all public address books.

List Private Address Books

Action

List all private address books.

List Address Books

Action

List all address books.

Delete Address Book

Action

Deletes an address book by ID.

Delete Contact From Address Book

Action

Deletes a contact from a given address book.

Add Contact To Address Book

Action

Adds a contact to a given address book.

Programs2

List Programs

Action

List all programs.

Create Enrolment

Action

Creates a program enrolment.

Contacts (Unified)4

Import Contact

Action

Import a single contact.

List Contacts by Criteria

Action

List all contacts based on criteria.

Get Contact By Identifier

Action

Gets a contact by an identifier.

Create Contact

Action

Create a contact.

Surveys1

List New Surveys With Activity

Action

List all surveys in the account that have changed since the last successful run.

Transactional Email2

Send Transactional Email

Action

Sends a transactional email.

Send Transactional Email Using A Triggered Campaign

Action

Sends a transactional email using a triggered campaign.

Preferences and Subscriptions4

Resubscribe Contact

Action

Resubscribes a previously unsubscribed contact.

Unsubscribe Contact

Action

Unsubscribes contact from account.

List New Suppressed Contacts

Action

List all suppressed contactssince the last successful run along with the reason for suppression.

List New Unsubscribed Contacts

Action

List all unsubscribed contacts since the last successful run.

CPaaS30

List Templates

Action

List all available templates.

Chat Updated Event

Webhook

Chat Updated Event

List Conversations

Action

List all available conversations.

Chat Deleted Event

Webhook

Webhook Event.

Chat Channel Updated Event

Webhook

Chat Channel Updated Event

Message Read Event

Webhook

Message Read Event

Inbound Event Combined

Webhook

Inbound event (all types)

Message Failed Event

Webhook

Message Failed Event.

Message Delivered Event

Webhook

Message Delivered Event

Message Expired Event

Webhook

Message Expired Event

Inbound Twitter

Webhook

Message Twitter Direct Message

Inbound Facebook Message

Webhook

Message inbound Facebook message.

Message Events

Webhook

Message events sent, delivered, read, expired, failed, inbound

Inbound App Message

Webhook

Message inbound app message.

Inbound SMS

Webhook

Message inbound event SMS.

Message Sent Event

Webhook

Message Sent Event

Chat Team Changed Event

Webhook

Chat Team Changed Event.

Chat Participant Added Event

Webhook

Chat Participant Added Event

Chat Delivered Event

Webhook

Chat Delivered Event.

Chat Event

Webhook

Looks for the following events. create, channelUpdated,update teamChanged, closed, delete, participantAdded, participantRemoved, status, sent, delivered, read

Send Messages

Action

Sends a batch of messages.

List Message Analytics

Action

List all message analytics.

Chat Created Event

Webhook

Chat Created Event.

Chat Status Event

Webhook

Chat Status Event.

Chat Participant Removed Event

Webhook

Chat Participant Removed Event.

Chat Closed Event

Webhook

Chat Closed Event.

Chat Read Event

Webhook

Chat Read Event

Chat Sent Event

Webhook

Chat Sent Event

Send SMS Messages

Action

Sends a batch of SMS messages.

Get Message Status

Action

Get Message Status.

Insight and Transactional Data5

List Transactional Data Collection For Contact By Email (Depreciated)

Action

List up to 100 of the most recent transactional data records for a contact in a collection by their email address.

Delete Transactional Data By Key (Depreciated)

Action

Deletes a piece of transactional data by key.

Replace Transactional Data By Key (Depreciated)

Action

Replaces a piece of transactional data by key.

Get Transactional Data By Key (Depreciated)

Action

Gets a piece of transactional data by key.

Add Transactional Data To Contact (Depreciated)

Action

Adds a single piece of transactional data to a contact.

TECHNICAL DETAILS

dotdigital integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing dotdigital integrations in Cyclr.

API and authentication

API host
Region-specific API endpoint (shown in the customer’s dotdigital account)
Authentication
Username/password; OAuth 2.0
Credentials

Username; Password; Account Region (r1/r2/r3)

Method categories

Contacts; Lists; Campaigns; Programs; Transactional messages; Webhooks; Reports

View vendor API documentation →

IMPLEMENTATION

Authentication at a glance

Cyclr accepts a dotdigital API user (auto-generated username and password) plus Account Region. Vendor also documents OAuth 2.0; confirm OAuth availability in your Cyclr Console. (community.cyclr.com)

Authentication method
Username/password; OAuth 2.0
Credential required

Username; Password; Account Region (r1/r2/r3)

Before you begin:

Requires creating a dotdigital API user and selecting the correct account region. (community.cyclr.com)

View setup guide

COMMON QUESTIONS

Frequently asked questions

It syncs contacts and lists, triggers campaigns and transactional sends, runs automation programs and receives delivery and engagement webhooks. Use these operations to build end-to-end marketing workflows inside your product. (marketing.developer.dotdigital.com)

Cyclr installs using a dotdigital API user (an auto-generated username and a password) plus an Account Region; dotdigital also supports OAuth 2.0 — confirm OAuth options in Cyclr Console. (community.cyclr.com)

Yes. Cyclr stores per-customer dotdigital credentials and region selection so you can deploy the same integration across tenants while keeping each account isolated. (community.cyclr.com)

Yes. You can expose selected dotdigital actions (contacts, campaigns, webhooks) as MCP-managed tools with centralized governance and audited use across customers. Cyclr controls access and reusable orchestration. (community.cyclr.com)