Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Emarsys (Actions) Destination


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Emarsys (Actions) in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta
(information)

Additional versions of this destination are available

This page is about the Emarsys (Actions) Destination. See below for information about other versions of the Emarsys destination:

Emarsys(link takes you to an external page) Emarsys, An SAP Company, is the omnichannel customer engagement platform, which empowers marketers to build, launch, and scale personalized cross-channel campaigns that drive business outcomes. By rapidly aligning desired business results with proven omnichannel customer engagement strategies the platform enables marketers to accelerate time to value, deliver superior 1:1 experiences and produce measurable results fast.


Benefits of Emarsys (Actions) vs Emarsys Classic

benefits-of-emarsys-actions-vs-emarsys-classic page anchor

Emarsys (Actions) provides the following benefits over the classic Emarsys destination:

  • Easy self-setup. Use standard API credentials to connect to an Emarsys account.
  • Standard actions. Use standard API functionality to manage contacts and start marketing automations.

  1. In the Segment web app, go to Catalog > Destinations.
  2. In the left menu, click Destination Actions.
  3. Click Configure Actions Emarsys.
  4. Select an existing Source to connect to Emarsys (Actions).
  5. Click Customized Setup to start with an empty mapping.

Important differences compared to the classic Emarsys destination

important-differences-compared-to-the-classic-emarsys-destination page anchor

The classic Emarsys destination handles any kind of Segment traffic but it requires additional configuration in the Emarsys account. Emarsys (Actions) does not need additional configuration in the Emarsys account, it is only configured in the Segment user interface. Please note that standard API rate limits apply.


Property nameTypeRequiredDescription
API passwordpassword
required

Your Emarsys API password.


API usernamestring
required

Your Emarsys API username


Build your own Mappings. Combine supported triggers with the following Emarsys-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Add to Contact List

add-to-contact-list page anchor

Add a contact to a contact list. The contact must exist before it can be added.

Add to Contact List is a Cloud action.

Property nameTypeRequiredDescription
Id of the contact listINTEGER
required

The Id of the contactlist


Key fieldSTRING
required

The field to use to find the contact


Key valueSTRING
required

Value for the key field used to find the contact. E.g. the email address


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.

Remove from Contact List

remove-from-contact-list page anchor

Remove a contact from a contact list.

Remove from Contact List is a Cloud action.

Property nameTypeRequiredDescription
Id of the contact listINTEGER
required

The Id of the contactlist


Key fieldSTRING
required

The field to use to find the contact


Key valueSTRING
required

Value for the key field used to find the contact. E.g. the email address


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.

Insert or update a contact on the Emarsys platform

Upsert Contact is a Cloud action.

Property nameTypeRequiredDescription
Key fieldSTRING
required

The field to use to find the contact


Key valueSTRING
required

Value for the key field used to find the contact. E.g. the email address


Fields to writeOBJECT
required

Use the emarsys field id (number) as key and set a value (string) (static, function or event variable)


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.

Trigger an external event on the Emarsys platform to launch automation programs. Note: You can only pass objects to event_payload (no literals, no arrays).

Trigger Event is a Cloud action.

Property nameTypeRequiredDescription
Id of the external eventINTEGER
required

The Id of the external event


Key fieldSTRING
required

The field to use to find the contact


Key valueSTRING
required

Value for the key field used to find the contact. E.g. the email address


Event payloadOBJECT

Optional

A JSON object that will be passed to the Emarsys template engine and can be used for personalization


Enable Batching?BOOLEAN

Optional

When enabled, Segment will send events in batches.