This article describes how to set up the dotdigital connector in your Customer Data Hub account.

Table of Contents Placeholder

How it Works

The dotdigital connector provides digital marketing professionals with SaaS technology solutions and tools, and offers an email marketing platform.

Connector Actions

Action Name AudienceStream EventStream
Trigger Campaign
Send Email Using a Triggered Campaign
Send SMS
Create or Update Contact
Add Contact to Address Book
Delete Contact from Address Book

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

  • API Username
    • Username for your API user.
    • To get started using the API, you must first create an API user.
    • These API user credentials (username/password) are required to authenticate each operation/method call and to ensure that you are connected to the correct account.
    • For setup information, see the following vendor documentation: Getting Started with the API
  • API Password
    • Password for your API user.
  • Region ID
    • Region ID to be included in every API endpoint.
    • You can find your API endpoint under Settings > Access > API users.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Trigger Campaign

Parameters

Parameter Description
Campaign ID
  • The ID of the campaign, which needs to be included within the request body.
Address Book ID
  • The Address Book ID the campaign is to be sent to.
  • You must specify either an Address Book ID or a Contact ID.
Contact ID
  • The Contact ID the campaign is to be sent to.
  • You must specify either an Address Book ID or a Contact ID.
Send Date
  • The date and time at which you want the campaign to be sent.

Action - Send Email Using a Triggered Campaign

Parameters

Parameter Description
To Address
  • The email address of the recipient.
Campaign ID
Personalization Values
  • Each personalization value is a key-value pair.

Action - Send SMS

Parameters

Parameter Description
Telephone Number
  • The mobile number of the contact.
Message
  • The SMS message to be sent to your contact's mobile phone.

Action - Create or Update Contact

Parameters

Parameter Description
Email
  • The email address of the contact.
  • For more information on this endpoint, see the following vendor documentation: Create contact.
Data Fields
  • Each contact data field is a key-value pair.
Opt-In Type
  • The opt-in type of the contact.
Email Type
  • The email type of the contact.
Contact Id
  • The ID of the contact.
  • This must be set to update a contact.

Action - Add Contact to Address Book

Parameters

Parameter Description
Address Book ID
  • The ID of the Address Book.
  • For more information on this endpoint, see the following vendor documentation: Add contact to address book.
Email
  • The email address of the contact.
  • For more information on this endpoint, see the following vendor documentation: Create contact.
Data Fields
  • Each contact data field is a key/value pair.
Opt-In Type
  • The opt-in type of the contact.
Email Type
  • The email type of the contact.

Action - Delete Contact from Address Book

Parameters

Parameter Description
Address Book ID
Contact ID
  • The ID of the contact to be deleted.