dotmailer Connector Setup Guide

dotmailer Connector Setup Guide

by 4 weeks ago - edited 4 weeks ago (52 Views)

The dotmailer connector provides digital marketing professionals with SaaS technology solutions and tools, and offers an email marketing platform. This article describes how to set up the dotmailer connector in your Universal Data Hub account.

Table of Contents Placeholder

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 our API, you will need to create an API user. These API user credentials (username/password) are required to authenticate each operation/method call you make, and to make sure you are connected to the correct account.
    For more information on how to set one up, 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 The ID of the triggered campaign. For more information on this endpoint, see the following vendor documentation: Send transactional email using a triggered campaign.
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.