--- title: "Connect Agillic" description: "Create an API key in Agillic, connect it with the developer key and secret, and create or update recipients with the fields you choose." url: https://scratcher.io/help/integrations/agillic language: en --- 1. [Help center](https://scratcher.io/help) 2. [Integrations](https://scratcher.io/help/integrations) 3. Connect Agillic # Connect Agillic Create an API key in Agillic, connect it with the developer key and secret, and create or update recipients with the fields you choose. With the Agillic integration, everyone who signs up is created or updated as a recipient in Agillic. Agillic doesn't use lists here: recipients are added to your Agillic data, and you build your target groups in Agillic. ## What you need - An Agillic account on Agillic's European platform, and a user who can create API keys (usually an administrator). ## Step 1: Create an API key in Agillic 1. In Agillic, open **Settings** and find the API keys (API credentials). 2. Create a new key, and give it a name you recognise, for example "Scratcher". 3. Copy the **Developer key** (also called API key) and the **Secret**. The secret is only shown once. ## Permissions the key needs Scratcher uses the key to read your person data fields, find recipients by email, and create and update recipients. If Agillic lets you limit the key, it needs read and write access to recipients and read access to person data. No other access is needed. ## Step 2: Connect Agillic to Scratcher 1. In Scratcher, go to **Settings** > **Integrations** and click **Agillic**. 2. Paste the **Developer key** and the **Secret**. 3. Click **Install integration**. Scratcher logs in to Agillic to check them. ## Step 3: Turn it on in a campaign 1. In the editor, go to **Connect** > **Integrations** > **Agillic** and click **Activate**. 2. If you have connected more than one account, choose it under **Select account**. 3. Under **Field mappings**, match each **Scratcher field** to an Agillic person data field. 4. Under **Unique email field**, choose the Agillic field you use for email: "Choose the field in Agillic that you use for email (ensure it is unique in Agillic as well)". Only unique text fields are listed. If you leave it empty, Scratcher uses the field **EMAIL**. 5. Under **Filter by permissions (optional)**, choose your marketing consent checkbox, so only people who said yes are sent. 6. Click **Save**, and then **Test**. > Good to know: Agillic has no list to choose, so Scratcher starts sending as soon as you click **Activate**. Activate it before the campaign goes live, or set it up right away. ## Field mapping - The email address is always sent to the unique email field. You don't need to map it. - The field list shows your Agillic person data, with its types. Dates are sent in Agillic's format, for example 31.12.2025. - If you have a person data field for opt-in, map a consent's **Accepted** field to it. ## What is sent and when Scratcher looks up the recipient by email. If they don't exist, they are created; otherwise they are updated. New sign-ups are sent within a minute or two, and existing leads are sent when you activate it. Under **Settings** > **Integrations** > **Delivery status** you can see whether each lead was new or already existed in Agillic. ## Troubleshooting - "Agillic API request failed with status code ...": Agillic didn't accept the request. 401 or 403 means the key was deleted or lacks access; connect a new key. - An Agillic message about a field: a value doesn't fit the field type, or a required field is missing. Check the mappings. 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.