--- title: "Connect Iterable" description: "Create a server-side API key in Iterable, connect it, and add new sign-ups as users to an Iterable list." url: https://scratcher.io/help/integrations/iterable language: en --- 1. [Help center](https://scratcher.io/help) 2. [Integrations](https://scratcher.io/help/integrations) 3. Connect Iterable # Connect Iterable Create a server-side API key in Iterable, connect it, and add new sign-ups as users to an Iterable list. With the Iterable integration, everyone who signs up is created or updated as a user in Iterable, identified by their email address, and subscribed to the Iterable list you choose. ## What you need - An Iterable project that uses email as the user identifier, and a user with permission to manage API keys (usually an org admin or project admin). - To know whether your Iterable project is in the US or the EU data center. ## Step 1: Create an API key in Iterable 1. In Iterable, go to **Integrations** > **API Keys**. 2. Click **New API Key**. 3. Name it, for example "Scratcher", and choose the type **Standard** (server-side). 4. Click to create the key, and copy it. Iterable only shows the whole key once. ## What the key is used for A standard (server-side) key can do what Scratcher needs: - read your lists and user fields, so you can choose them in the campaign; - create and update users; - subscribe users to lists. Don't use a JavaScript, mobile or read-only key: they can't add users from a server. ## Step 2: Connect Iterable to Scratcher 1. In Scratcher, go to **Settings** > **Integrations** and click **Iterable**. 2. Choose the data center (US or EU), and paste the API key. 3. Click **Install integration**. Scratcher checks that it can read your lists. ## Step 3: Turn it on in a campaign 1. In the editor, go to **Connect** > **Integrations** > **Iterable** and click **Activate**. 2. If you have connected more than one project, choose it under **Select account**. 3. Under **External list**, choose the Iterable list. Only static lists can be chosen. 4. Under **Field mappings**, click **Add field mapping** and match each **Scratcher field** to an Iterable user field, for example "Lead - First name" to **firstName**. 5. Under **Filter by permissions (optional)**, choose your marketing consent checkbox. 6. Click **Save**, and then **Test**. ## Field mapping - The email address is always sent and identifies the user. You don't need to map it. - The **Destination field** list shows the user fields in your project. If a field doesn't exist yet, create it in Iterable first, so it gets the right type. - For phone numbers, use **Format** with + and country code, which Iterable expects for SMS. ## Consent Being on a list doesn't subscribe people to your message types by itself: Iterable uses its own subscription settings for that. Only send people who said yes, by choosing your marketing checkbox under **Filter by permissions (optional)**. You can also map a consent's **Accepted** and **Date** fields to user fields, so you have proof of consent in Iterable. ## 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. When someone takes part again, the user is updated. Use the list as the start of a journey in Iterable to send a welcome message. Every delivery shows under **Settings** > **Integrations** > **Delivery status**. ## Troubleshooting - "All or some of the fields are invalid..." when installing: the key is wrong or not a standard key, or you chose the wrong data center. - A field is rejected: the value doesn't fit the type of the user field in Iterable, for example text in a date field. Check the mapping. - The list is missing: dynamic lists can't receive users. Create a static list in Iterable. 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.