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 Customer 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) |