Emarsys Connector Setup Guide

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

Emarsys is a comprehensive cloud-based B2C (Business to Consumer) marketing platform that fully maximizes customer value through data science and artificial intelligence marketing.

Connector actions

Action Name AudienceStream EventStream
Add Contact to Contact List (deprecated v1)
Add Contact to Contact List
Create or Update Email Contact (deprecated v1)
Create or Update Email Contact
Remove Contact From Contact List (deprecated v1)
Remove Contact From Contact List
Trigger Transactional Email (deprecated v1)
Trigger Transactional Email
Unsubscribe Contact From Email Campaign

Configure settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

After adding the connector, configure the following settings:

  • Username: Username with permissions to access Emarsys APID. For more information about the Emarsys APID username, see the Emarsys Get started article.
  • Password: Password for provided username.
  • Environment: Environment to make API calls against.

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 - Add Contact to Contact List (deprecated v1)

Parameters

Parameter Description
Target Contact List
  • Required
  • The contact list to add the contact to
  • Use Custom Value if you know and want to configure the ID of the target contact list manually.
First Name
Last Name
E-Mail
Date of Birth
Gender
Marital Status
Children
Education
Title
Address
City
State
ZIP Code
Country
Phone
Fax
Job Position
Company
Department
Industry
Phone (office)
Fax (office)
Number of Employees
Annual Revenue (in OOO EUR)
URL
Preferred e-mail format
Opt-in
Registration Language
Mobile
First Name of Partner
Birth Date of Partner
Anniversary
Company Address
Zip Code (office)
City (office)
State (office)
Country (office)
Salutation

Action - Add Contact to Contact List

Parameters

Parameter Description
Target Contact List
  • Required
  • The contact list to add the contact to
  • Use Custom Value if you know and want to configure the ID of the target contact list manually.

Action - Create or Update Email Contact (deprecated v1)

Parameters

Parameter Description
Create If Not Exists When enabled, if the contact does not exist, it is created automatically
Source ID
  • An optional ID assigned to a customer’s external application, and is used to identify contacts created or modified by the external applications
Contact Identifying Field
  • Required
  • This is the field used to identify a contact
First Name
Last Name
E-Mail
Date of Birth
Gender
Marital Status
Children
Education
Title
Address
City
State
ZIP Code
Country
Phone
Fax
Job Position
Company
Department
Industry
Phone (office)
Fax (office)
Number of Employees
Annual Revenue (in OOO EUR)
URL
Preferred e-mail format
Opt-in
Registration Language
Mobile
First Name of Partner
Birth Date of Partner
Anniversary
Company Address
Zip Code (office)
City (office)
State (office)
Country (office)
Salutation

Action - Create or Update Email Contact

Parameters

Parameter Description
Create If Not Exists When enabled, if the contact does not exist, it is created automatically
Source ID
  • An optional ID assigned to a customer’s external application, and is used to identify contacts created or modified by the external applications
Contact Identifying Field
  • Required
  • This is the field used to identify a contact
  • Use Custom Value if you know and want to configure the ID of the target contact field manually.

Action - Remove Contact From Contact List (deprecated v1)

Parameters

Parameter Description
Target Contact List
  • Required
  • The contact list to remove the contact from
  • Use Custom Value if you know and want to configure the ID of the target contact list manually.
First Name
Last Name
E-Mail
Date of Birth
Gender
Marital Status
Children
Education
Title
Address
City
State
ZIP Code
Country
Phone
Fax
Job Position
Company
Department
Industry
Phone (office)
Fax (office)
Number of Employees
Annual Revenue (in OOO EUR)
URL
Preferred e-mail format
Opt-in
Registration Language
Mobile
First Name of Partner
Birth Date of Partner
Anniversary
Company Address
Zip Code (office)
City (office)
State (office)
Country (office)
Salutation

Action - Remove Contact From Contact List

Parameters

Parameter Description
Target Contact List
  • Required
  • The contact list to remove the contact from
  • Use Custom Value if you know and want to configure the ID of the target contact list manually.

Action - Trigger Transactional Email (deprecated v1)

Parameters

Parameter Description
External Event
  • Required
  • Select event set to trigger email
First Name
Last Name
E-Mail
Date of Birth
Gender
Marital Status
Children
Education
Title
Address
City
State
ZIP Code
Country
Phone
Fax
Job Position
Company
Department
Industry
Phone (office)
Fax (office)
Number of Employees
Annual Revenue (in OOO EUR)
URL
Preferred e-mail format
Opt-in
Registration Language
Mobile
First Name of Partner
Birth Date of Partner
Anniversary
Company Address
Zip Code (office)
City (office)
State (office)
Country (office)
Salutation
Content Personalization Data to Set
  • Optional
  • Place holder in email and the value to replace it with

Action - Trigger Transactional Email

Parameters

Parameter Description
External Event
  • Required
  • Select event set to trigger email
Content Personalization Data to Set
  • Optional
  • Place holder in email and the value to replace it with

Action - Unsubscribe Contact From Email Campaign

Parameters

Parameter Description
Launch List ID (Required)
Email Campaign ID (Required)
Contact ID (Required)

Was this page helpful?

This page was last updated: January 23, 2020