--- title: "Connect Mapp" description: "Create an API user in Mapp Engage, connect it, and add new sign-ups as contacts to a Mapp group." url: https://scratcher.io/help/integrations/mapp language: en --- 1. [Help center](https://scratcher.io/help) 2. [Integrations](https://scratcher.io/help/integrations) 3. Connect Mapp # Connect Mapp Create an API user in Mapp Engage, connect it, and add new sign-ups as contacts to a Mapp group. With the Mapp integration, everyone who signs up is created or updated as a contact in Mapp Engage and added to the group (list) you choose. ## What you need - A Mapp Engage account, and a user who can create system users (usually an administrator). - Your Mapp Engage API address. It is the address of your Mapp Engage system with the API path, and you find it in Mapp's API documentation for your system, or by asking Mapp support. ## Step 1: Create an API user in Mapp Engage Mapp Engage uses a separate user for the API, with a username and password. 1. In Mapp Engage, go to **Administration** > **System Users**. 2. Create a new system user and name it for example "Scratcher". 3. Give the user the API role (API access), with the rights below. 4. Set a strong password and save. Copy the username and the password. ## Rights the API user needs Scratcher uses the user to: - read your groups, so you can choose one in the campaign; - read your contact attributes, so you can map fields to them; - create and update contacts; - add contacts to groups (subscribe them). The user doesn't need access to messages, reports or anything else. ## Step 2: Connect Mapp to Scratcher 1. In Scratcher, go to **Settings** > **Integrations** and click **Mapp**. 2. Paste the API address, the username and the password in the matching fields. 3. Click **Install integration**. Scratcher checks that it can read your groups. ## Step 3: Turn it on in a campaign 1. In the editor, go to **Connect** > **Integrations** > **Mapp** and click **Activate**. 2. If you have connected more than one account, choose it under **Select account**. 3. Under **External list**, choose the Mapp group. 4. Under **Field mappings**, click **Add field mapping** and match each **Scratcher field** to a Mapp attribute, 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 contact. You don't need to map it. - The **Destination field** list shows the standard and custom attributes in your Mapp system. Create custom attributes in Mapp first. - For mobile numbers, use the **Format** setting. Mapp usually expects + and country code. ## Consent Contacts are subscribed to the group you choose. If the group uses double opt-in in Mapp, Mapp sends its own confirmation email, and people are only subscribed when they confirm. Use **Filter by permissions** so only people who ticked your marketing checkbox are added. ## What is sent and when New sign-ups are sent within a minute or two. When you activate the integration, the campaign's existing leads are sent too. When someone takes part again, the contact is updated. Check every delivery under **Settings** > **Integrations** > **Delivery status**. ## Troubleshooting - "All or some of the fields are invalid..." when installing: check the API address, and that the system user has the API role and isn't locked. - Deliveries fail with an access error: the system user lacks one of the rights above. - The password expired: some Mapp systems make passwords expire. Set a new password in Mapp and connect again with **Add new account**. 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.