--- title: "Connect Emarsys" description: "Create API credentials with the right permissions in Emarsys, connect them to Scratcher and add new sign-ups to an Emarsys contact list." url: https://scratcher.io/help/integrations/emarsys language: en --- 1. [Help center](https://scratcher.io/help) 2. [Integrations](https://scratcher.io/help/integrations) 3. Connect Emarsys # Connect Emarsys Create API credentials with the right permissions in Emarsys, connect them to Scratcher and add new sign-ups to an Emarsys contact list. With the Emarsys integration, everyone who signs up is created or updated as a contact in Emarsys and added to the contact list you choose. ## What you need - An Emarsys account, and a user who can manage API credentials (under **Management** > **Security Settings**). ## Step 1: Create API credentials in Emarsys 1. In Emarsys, go to **Management** > **Security Settings** > **API Credentials**. 2. Click **Create API Credentials**, and make sure to select **OpenID Connect**. 3. Under **Permissions**, turn on these four: `contact.create`, `contact.update`, `contactlist.list` and `field.list`. 4. Save, and copy the **Client ID** and the **Client Secret**. You need both in Scratcher. ## Permissions the credentials need - `contact.create` and `contact.update`: to create new contacts and update existing ones. - `contactlist.list`: to show your contact lists in the campaign. - `field.list`: to show your Emarsys fields in the field mapping. No other permissions are needed. ## Step 2: Connect Emarsys to Scratcher 1. In Scratcher, go to **Settings** > **Integrations** and click **Emarsys**. The **Setup guide** in the dialog repeats the steps above. 2. Paste the **Client ID** and **Client secret**. 3. Click **Install integration**. Scratcher checks that it can read your contact lists. ## Step 3: Turn it on in a campaign 1. In the editor, go to **Connect** > **Integrations** > **Emarsys** and click **Activate**. 2. If you have connected more than one account, choose it under **Select account**. 3. Under **External list**, choose the contact list. 4. Under **Field mappings**, map at least "Lead - Email" to the Emarsys **Email** field, and then your other fields, for example **First Name** and **Last Name**. Emarsys fields are listed by name. 5. Under **Filter by permissions (optional)**, choose your marketing consent checkbox. 6. Click **Save**, and then **Test**. ## Field mapping - Map the email address yourself. Emarsys uses it to find existing contacts, so a contact without it can't be matched. - Only the fields you map are sent. - Some Emarsys system fields, such as opt-in, registration date and newsletter, aren't offered, because Emarsys sets them itself. ## Consent Scratcher sets the contact's opt-in field in Emarsys to "true" for everyone it sends. So always use **Filter by permissions (optional)** with your marketing consent checkbox, if it's optional on your form. ## What is sent and when New sign-ups are sent within a minute or two, and the campaign's existing leads are sent when you activate it. If the contact already exists, it is updated and added to the list. ## Troubleshooting - "All or some of the fields are invalid..." when installing: the client ID or secret is wrong, or the credentials don't use OpenID Connect. - Deliveries fail, or the list or field dropdowns are empty: the credentials are missing one of the four permissions. Edit them in Emarsys. - Contacts are created twice: "Lead - Email" isn't mapped to the **Email** field. Integrations - [How integrations work](https://scratcher.io/help/integrations/how-integrations-work) - [All integrations](https://scratcher.io/help/integrations/other-integrations) - [Check the delivery status and resend leads](https://scratcher.io/help/integrations/delivery-status) - [Connect HubSpot](https://scratcher.io/help/integrations/hubspot) - [Connect Salesforce Marketing Cloud](https://scratcher.io/help/integrations/salesforce-marketing-cloud) - [Connect Microsoft Dynamics 365 with Zapier](https://scratcher.io/help/integrations/microsoft-dynamics-365) - [Connect Emarsys](https://scratcher.io/help/integrations/emarsys) - [Connect Klaviyo](https://scratcher.io/help/integrations/klaviyo) - [Connect Mailchimp](https://scratcher.io/help/integrations/mailchimp) - [Connect ActiveCampaign](https://scratcher.io/help/integrations/activecampaign) - [Connect Apsis One](https://scratcher.io/help/integrations/apsis-one) - [Connect Drip](https://scratcher.io/help/integrations/drip) - [Connect HeyLoyalty](https://scratcher.io/help/integrations/heyloyalty) - [Connect Peytz](https://scratcher.io/help/integrations/peytz) - [Connect Marketingplatform](https://scratcher.io/help/integrations/marketingplatform) - [Connect Campaign Monitor with Zapier](https://scratcher.io/help/integrations/campaign-monitor) - [Connect ActiveTrail with Zapier](https://scratcher.io/help/integrations/activetrail) - [Connect Bloomreach](https://scratcher.io/help/integrations/bloomreach) - [Connect Iterable](https://scratcher.io/help/integrations/iterable) - [Connect Mapp](https://scratcher.io/help/integrations/mapp) - [Connect Agillic](https://scratcher.io/help/integrations/agillic) - [Connect Ortto](https://scratcher.io/help/integrations/ortto) - [Connect Emarketeer](https://scratcher.io/help/integrations/emarketeer) - [Connect Shopify](https://scratcher.io/help/integrations/shopify) - [Connect Hello Retail](https://scratcher.io/help/integrations/hello-retail) - [Connect 8,000+ apps with Zapier](https://scratcher.io/help/integrations/zapier) - [Connect monday.com with Zapier](https://scratcher.io/help/integrations/monday-com) - [Connect Asana with Zapier](https://scratcher.io/help/integrations/asana) - [Connect Podio with Zapier](https://scratcher.io/help/integrations/podio) - [Connect Intercom with Zapier](https://scratcher.io/help/integrations/intercom) ## Related articles - [How integrations work](https://scratcher.io/help/integrations/how-integrations-work): Connect your email tool or CRM once, turn it on in each campaign, choose a list, map your fields and send only people who gave consent. - [Check the delivery status and resend leads](https://scratcher.io/help/integrations/delivery-status): See which leads were sent to your tools, understand the error messages, fix the problem and send them again. - [Ask for consent and add terms and conditions](https://scratcher.io/help/forms/consent-and-permissions): Add consent checkboxes for newsletters, link your terms, choose which checkbox subscribes people and send only people who said yes to your email tool. ## Still need help? Real people are here to help. If you already use Scratcher, the quickest way is the chat inside the platform. - **[Chat with us](https://platform.scratcher.io/login)** Log in and click the chat button in the bottom-right corner. Rex answers right away, and our team is a click away. - **[Book a meeting](https://scratcher.io/book-a-meeting)** A free 30-minute video call with our team: a tour, campaign ideas or help with your setup. - **[Email us](mailto:contact@scratcher.io)** Write to contact@scratcher.io and we will get back to you.