> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Emarsys Contacts Writeback Connector

## Intro

Emarsys, a leading provider of marketing software, enables true, one-to-one interactions between marketers and consumers. Use Domo’s Emarsys Contacts Writeback connector to export your contacts data from a Domo dataset to your Emarsys account. To learn more about the Emarsys API, visit their page [https://dev.emarsys.com/v2/emarsys-developer-hub/what-is-the-emarsys-api](https://dev.emarsys.com/v2/emarsys-developer-hub/what-is-the-emarsys-api).

You configure your Domo- Emarsys Contacts connection in the Data Center. This topic discusses the fields and menus that are specific to the Emarsys Contacts Writeback Connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

<Note>
  **Note:** The owner of a writeback dataset must also be an owner or co-owner of the input dataset.
</Note>

## Prerequisites

To configure this Connector, you must have the following:

* Your Domo developer account client ID and client secret
* Your Emarsys Contacts username and secret

##### To obtain your Domo developer credentials, do the following:

1. Log into the [Domo developer account](https://developer.domo.com/login "https://developer.domo.com/login").
2. In the top right corner under **My Account** click **New Client**.
3. Enter the application name and description.
4. Provide the application scope by selecting the checkboxes for **Data** and **User**.
5. Click **Create**.

Once you have created a client, you can manage the client by clicking on **Manage Client**.

## Configuring the Connection

This section enumerates the options in the **Credentials** and **Details** panes in the Emarsys Contacts Writeback Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most Connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

### Credentials Pane

This pane contains fields for entering credentials to connect to your Emarsys Contacts account where you want your data to be copied to. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Domo Client ID </td><td colspan="1" rowspan="1"><p><span> Enter your Domo client ID. </span></p></td></tr><tr><td colspan="1" rowspan="1"> Domo Client Secret </td><td colspan="1" rowspan="1"><p><span> Enter your Domo client secret. </span></p></td></tr><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"><p> Enter your Emarsys Contacts username. </p></td></tr><tr><td colspan="1" rowspan="1"> Secret </td><td colspan="1" rowspan="1"><p> Enter your Emarsys Contacts secret. </p></td></tr></tbody></table>

Once you have entered valid credentials, you can use the same account any time you go to set up a new Domo-Emarsys Contacts Writeback DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a number of fields for specifying your data and indicating where it's going.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"> Contacts </td><td colspan="1" rowspan="1"> Write data from Domo to Emarsys contacts. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Enter a dataset to map the fields here </p></td><td colspan="1" rowspan="1"><p> Enter the id of your Domo dataset containing data to write to Emarsys Contacts. </p></td></tr><tr><td colspan="1" rowspan="1"> Enter the DataSet ID </td><td colspan="1" rowspan="1"><p> The ID is located in the dataset URL. </p><p> Example: <a href="https://customer.domo.com/datasources/" rel="noopener" target="_blank"> [https://customer.domo.com/datasources/](https://customer.domo.com/datasources/) </a><b> aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee </b> /details/settings </p></td></tr><tr><td colspan="1" rowspan="1"><p> Emarsys Setup </p></td><td colspan="1" rowspan="1"> Enter the needed details for Emarsys </td></tr><tr><td colspan="1" rowspan="1"><p> Export contacts to a contact list </p></td><td colspan="1" rowspan="1"> Select this checkbox if you want to export contacts to a contact list. </td></tr><tr><td colspan="1" rowspan="1"> Configuration Mapping </td><td colspan="1" rowspan="1"> Select whether to use automated mapping (if your dataset fields match Emarsys Contacts Fields) or to define the mapping manually. </td></tr><tr><td colspan="1" rowspan="1"> Use automated mapping </td><td colspan="1" rowspan="1"> Generating the mapping automatically only works if the Emarsys Contacts Fields and Dataset Fields are an exact match. Don't see the fields you are expecting via automated mapping? Try manual mapping. </td></tr><tr><td colspan="1" rowspan="1"> Select mapping manually </td><td colspan="1" rowspan="1"><p> For manual mapping, match the desired Emarsys Contacts fields and dataset columns. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Emersys Contacts Fields </p></td><td colspan="1" rowspan="1"><p> Select the Emarsys Contacts fields to match with the desired DataSet fields. </p></td></tr><tr><td colspan="1" rowspan="1"><p> DataSet Fields </p></td><td colspan="1" rowspan="1"><p> Select the DataSet fields fields to match with the desired Emarsys Contacts fields. </p></td></tr><tr><td colspan="1" rowspan="1"> Unique Key Mapping </td><td colspan="1" rowspan="1"><p> Select a key to identify existing contacts that will be updated. Emarsys recommends using ID or UID to identify contacts and avoid conflicts that can happen when using the email field. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## FAQs

<AccordionGroup>
  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need your Domo Developer account credentials (client ID and client secret), and the username and secret associated with your Emarsys Contacts account.
  </Accordion>

  <Accordion title="How frequently will my data update?">
    As often as needed.
  </Accordion>

  <Accordion title="How do I find the Input Dataset ID?">
    Your Domo input dataset id is in the URL of the dataset you are exporting data from. For example:

    `https://customer.domo.com/datasources/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/details/settings`
  </Accordion>

  <Accordion title="What mapping options are available?">
    You can use automated mapping or define the mapping manually.
  </Accordion>

  <Accordion title="I don't see the expected fields via automated mapping. Why?">
    Generating the mapping automatically only works if the Emarsys Contacts Fields and Dataset Fields are an exact match. If you don't see the fields you are expecting via automated mapping, try manual mapping.
  </Accordion>
</AccordionGroup>
