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	✓	✗
Trigger an External Event	✓	✓

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 a 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 a custom value if you know and want to configure the ID of the target contact list manually.
Contact Lookup	Required The field and corresponding field data to identify the contact. Use a custom value if you know and want to configure the ID of the target contact list manually. For more information, see Emarsys API documentation.

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 a custom value if you know and want to configure the ID of the target contact field manually.
Contact Field Data to Set	The fields and corresponding field data that will be updated. At least one field is required to identify the contact. The only date format supported by the contact fields is YYYY-MM-DD. Some contact fields have limited acceptable values. For more information, see [Emarsys documentation].(https://dev.emarsys.com/docs/emarsys-api/1a17c3d6fcebc-list-available-choices-of-a-single-choice-field). Use a 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 a 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 a custom value if you know and want to configure the ID of the target contact list manually.
Contact Lookup	Required The field and corresponding field data to identify the contact. Use a custom value if you know and want to configure the ID of the target contact list manually. For more information, see Emarsys API documentation.

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 Placeholder 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 Placeholder in email and the value to replace it with.
Target Contact List	Required The contact list to remove the contact from. Use a custom value if you know and want to configure the ID of the target contact list manually.
Contact Lookup	Required The field and corresponding field data to identify the contact. Use a custom value if you know and want to configure the ID of the target contact list manually.

Action - Unsubscribe Contact From Email Campaign

Parameters

Parameter	Description
Launch List ID	(Required) Provide launch list ID from unsubscribe link in email.
Email Campaign ID	(Required) Provide email campaign ID from unsubscribe link in email.
Contact ID	(Required) Map randomly generated string to contact ID. Provided by unsubscribe link in email.

Action - Trigger an External Event

Parameters

Parameter	Description
External Event	Select event to trigger.
Contact Lookup	Required The field and corresponding field data to identify the contact. Use a custom value if you know and want to configure the ID of the target contact list manually. For more information, see Emarsys API documentation.
Event Time	The time of the event.
Event Data	The external data used for the trigger.
Template Variables	Provide template variables as data input for Templates. For more information, see Webhook Send Custom Request Template Variables Guide. Name nested template variables with the dot notation (for example: items.name). Nested template variables are typically built from data layer list attributes.
Templates	Provide templates to be referenced in External Event Data. For more information, see Webhook Send Custom Request Trimou Templating Engine Guide. Templates are injected by name with double curly braces into supported fields (for example: {{SomeTemplateName}}).