Emarsys Connector Setup Guide

Configuration

Go 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 Getting started article.
• Password: Password for provided username.
• Environment: Environment to make API calls against.

Actions

Action Name	AudienceStream	EventStream
Add Contact to Contact List (Real-Time)	✓	✗
Add Contact to Contact List (Batched)	✓	✗
Create or Update Email Contact (Real-Time)	✓	✗
Create or Update Email Contact (Batched)	✓	✗
Remove Contact From Contact List (Real-Time)	✓	✗
Remove Contact From Contact List (Batched)	✓	✗
Trigger Transactional Email (Real-Time)	✓	✗
Trigger Transactional Email (Batched)	✓	✗
Unsubscribe Contact From Email Campaign	✓	✗
Trigger an External Event (Real-Time)	✓	✓
Trigger an External Event (Batched)	✓	✓

Enter a name for the action and select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Add Contact to Contact List (Real-Time)

Parameters

Parameter	Description
Target Contact List	Required The contact list to add the contact to. If you know the ID of the target contact list and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. For more information, see Emarsys API documentation.

Add Contact to Contact List (Batched)

Parameters

Parameter	Description
Target Contact List	Required The contact list to add the contact to. If you know the ID of the target contact list and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. For more information, see Emarsys API documentation.

Create or Update Email Contact (Real-Time)

Parameters

Parameter	Description
Create If Not Exists	When enabled, if the contact does not exist, it is created automatically.
Contact Identifier Data	Required This is the field used to identify a contact. If you know the ID of the target contact field and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. 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. If you know the ID of the target contact field and want to configure it manually, use a custom value.

Optional

Parameter	Description
Source ID	An ID assigned to a customer’s external application, and is used to identify contacts created or modified by the external applications.

Create or Update Email Contact (Batched)

Parameters

Parameter	Description
Create If Not Exists	When enabled, if the contact does not exist, it is created automatically.
Contact Identifier Data	Required This is the field used to identify a contact. If you know the ID of the target contact field and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. 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. If you know the ID of the target contact field and want to configure it manually, use a custom value.

Optional

Parameter	Description
Source ID	An ID assigned to a customer’s external application, and is used to identify contacts created or modified by the external applications.

Remove Contact From Contact List (Real-Time)

Parameters

Parameter	Description
Target Contact List	Required The contact list to add the contact to. If you know the ID of the target contact list and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value. For more information, see Emarsys API documentation.

Remove Contact From Contact List (Batched)

Parameters

Parameter	Description
Target Contact List	Required The contact list to add the contact to. If you know the ID of the target contact list and want to configure it manually, use a custom value.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value. For more information, see Emarsys API documentation.

Trigger Transactional Email (Real-Time)

Parameters

Parameter	Description
External Event	Required Select event set to trigger email.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value.

Optional

Parameter	Description
Content Personalization Data	Optional Placeholder in email and the value to replace it with.

Trigger Transactional Email (Batched)

Parameters

Parameter	Description
External Event	Required Select event set to trigger email.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value.

Optional

Parameter	Description
Content Personalization Data	Optional Placeholder in email and the value to replace it with.

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.

Trigger an External Event (Real-Time)

Parameters

Parameter	Description
External Event	Select event to trigger.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value. For more information, see Emarsys API documentation.

Optional

Parameter	Description
External 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}}).

Trigger an External Event (Batched)

Parameters

Parameter	Description
External Event	Select event to trigger.
Contact Data	Required The field and corresponding field data to identify the contact. If you know the ID of the target contact list and want to configure it manually, use a custom value. For more information, see Emarsys API documentation.

Optional

Parameter	Description
External 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}}).