Back

Emarsys is a comprehensive cloud-based B2C (Business to Consumer) marketing platform that fully maximizes customer value through data science and artificial intelligence marketing. This article describes how to set up the Emarsys connector in your Universal Data Hub account.

Table of Contents Placeholder

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

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:

  • Username: Username with permissions to access Emarsys APIDon't have a username and password? Get started
  • 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)