Emarsys Connector Setup Guide

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)