You built a custom form on your Shopify store, maybe a wholesale application, quote request, contact form, or another form designed specifically for your business. Now you want every submission to go directly into a Mailchimp audience so you can manage contacts and follow up without manually moving data between platforms.
When you look for a Shopify Mailchimp integration, the most common suggestions are to use Mailchimp’s official Shopify app or embed one of Mailchimp’s own signup forms on your store. Those options can work well for standard Mailchimp forms, but they do not necessarily solve the problem when you already have a custom Shopify form that you want to keep using.
That is where a form-to-API connection becomes useful. Instead of replacing your existing form, you can connect its fields to Mailchimp and send each submission directly to the right audience. In this guide, we will walk through how to set up that connection using IPS – Contact Form to Any API, from installing the app and configuring the Mailchimp API connection to mapping your form fields and testing the submission. The goal is to help you connect your existing Shopify form to Mailchimp without rebuilding it as a separate signup form.
What connecting a Shopify form to Mailchimp actually means
Mailchimp’s official Shopify app already does one job well. It keeps your customer and order data flowing into Mailchimp automatically, syncing purchases, products, and buyer profiles as your store runs. If you want to sync Mailchimp with Shopify at the store level, that app is still the right tool, and nothing here replaces it.
This post solves a narrower problem. You have a custom form, maybe a wholesale application, a quote request, or a newsletter signup with a couple of extra fields, and you want only that form’s submissions routed into a specific Mailchimp audience. That’s not something the native sync touches.
The workflow looks like this. A customer fills out a form built in IPS – Contact Form to Any API. The app sends that submission to Mailchimp through an API integration you configure once. Mailchimp adds the contact to the audience you specified, with the fields mapped the way you set them up. That’s the specific Shopify Mailchimp integration this guide walks through.
1. Install IPS – Contact Form to Any API
Start by installing IPS – Contact Form to Any API from the Shopify App Store. Search for the app by name, or open its listing directly, and click Install. You don’t need a credit card to use the free plan, so you can set up the whole workflow before deciding whether to upgrade.
Once installed, open the app from your Shopify admin under Apps. This takes you to the app dashboard, where form building, submissions, integrations, and logs all live. Everything in the rest of this guide happens from that dashboard, so it’s worth bookmarking.
2. Create your Shopify contact form
With the app installed, create the form you want to connect to Mailchimp. From the dashboard, select Create New Form, or go to the Forms section and choose the same option.
You can start from one of the ready-made templates, organized by use case such as Contact Us, Wholesale, or Register, or build a blank form from scratch. If your goal is a newsletter signup or a lead capture form, a blank form usually gives you more control over which fields Mailchimp will receive.
Open the Elements section and add the fields your Mailchimp audience needs. At minimum, that means an Email field, since Mailchimp requires an email address for every contact. Most stores also add a Name field, and any custom field relevant to the audience, such as Company Name or a Dropdown for customer interest.
Keep the field list close to what you actually plan to use in Mailchimp. Every field you add here becomes something you can map in the next step, so extra fields you don’t need just add clutter to the mapping screen later.
Once your fields are in place, you can adjust the form’s appearance, footer text, and confirmation message under the Appearance and After Submit sections. None of that affects how the form connects to Mailchimp, so save those details for later and move on to the integration itself.
3. Configure the Mailchimp integration
This is where the Shopify Mailchimp integration actually gets built, and it happens independently of the form itself. You can set it up right after creating your form, or come back to it later from the Integrations section of the app.
Get your Mailchimp API key and audience ID
Before touching the app, log into Mailchimp and open Account, then Extra, then API Keys. Create a key if you don’t already have one, and copy it somewhere safe. Mailchimp API keys end with a short code after a dash, such as -us21. That code identifies your account’s data center, and you’ll need it for the next step.
Next, find your audience ID. Open the audience you want new contacts added to, go to its settings, and look for Audience name and defaults. The ID listed there is what Mailchimp calls a list ID, and it’s what points your integration at the right audience.
Set up the integration in the app
In IPS – Contact Form to Any API, go to Integrations and select Add new integration. Give it a name you’ll recognize later, something like Mailchimp Wholesale Form.
For the API endpoint URL, use your data center code and audience ID to build Mailchimp’s list members address:
https://[dc].api.mailchimp.com/3.0/lists/[audience-id]/members
Replace [dc] with your data center code and [audience-id] with the ID you copied.
Set Authentication to API key/headers, and add a request header carrying your Mailchimp API key so the request can authenticate:
Authorization: Bearer YOUR_MAILCHIMP_API_KEY
Leave Request body type on Raw JSON and Request method on POST, the same defaults the app uses for other API connections.
Map your form fields
Select the contact form you built in step two, then open the JSON payload editor. This is where accurate mapping matters most, since a field sent to the wrong place in Mailchimp either gets ignored or overwrites the wrong data.
At minimum, map your form’s email field to Mailchimp’s email_address key, and set a status value such as subscribed. Map any name or custom fields into Mailchimp’s merge_fields, using the merge tag names your audience already has, commonly FNAME and LNAME for a first and last name split.
Review the payload, save the integration, and you have a working Shopify Mailchimp integration ready to test.
4. Add the form to your Shopify store
With the integration saved, publish the form so it can actually appear on your storefront. Open the form in IPS – Contact Form to Any API and click Publish. A newly saved form starts as a draft, and Mailchimp won’t receive anything from a form that isn’t live.
After publishing, the app generates an HTML code for the form. Copy that code, then go to your Shopify admin and open Online Store, then Themes, then Customize. Navigate to the page where you want the form to appear, a dedicated Contact page or a custom section, then click Add block or Add section depending on your theme.
Select the Contact Form to API app block, and paste the HTML code you copied into the shortcode field. Save your theme changes, then open the storefront page to confirm the form displays correctly on both desktop and mobile before moving on to testing.
5. Test the Mailchimp integration
Before trusting this integration with real customer data, run one submission through it yourself. Open the published form on your storefront and submit a test entry using a real email address you can check, filling in every field you mapped in step three.
Log into Mailchimp and open the audience you connected the form to. Search for the email address you just submitted. If the integration is working, the contact appears there within a few moments, with each mapped field, name, company, or any custom field, showing the value you entered.
If the contact doesn’t show up, don’t guess at the cause. The next section covers exactly where to look, but the short version is that IPS – Contact Form to Any API keeps a record of every request it sends, which is the fastest way to confirm this Shopify Mailchimp integration is actually working before you rely on it store-wide.
Follow the Shopify documentation to learn about every functionality in detail.
6. Monitor your integration logs
Once your Shopify Mailchimp integration is live, Integration Logs becomes the place to check when something looks off. Open IPS – Contact Form to Any API and select Integration Logs from the app menu to see every API request your forms have sent, along with a running count of successful and failed requests.
Each log entry shows the data submitted through the form, the data actually sent to Mailchimp, the response Mailchimp returned, and a status such as successful or failed with an HTTP code. You can expand any of these as full JSON to see exactly what was sent and what came back, which is usually enough to tell you whether the problem is a field mapping, a credential, or something on Mailchimp’s side.
It’s worth knowing that this is separate from your form’s Submissions section, which stores every entry a customer submits regardless of whether an integration is connected. Even if you’re still setting up or troubleshooting the Mailchimp connection, none of that submitted data is lost.
Troubleshooting common issues
Most problems with a Shopify Mailchimp integration trace back to one of four places. Here’s how to recognize and fix each one.
- Fields landing in the wrong place
If contacts appear in Mailchimp but with missing or incorrect data, open the integration’s JSON payload and check each mapped value against Mailchimp’s merge tags for that audience. A field mapped to a merge tag that doesn’t exist, or a typo in a tag name like FNAME, will either get dropped or rejected. Compare your payload against the Sent Data to API section of a recent Integration Log to see exactly what was submitted.
- Authentication or connection failures
A failed request with an authentication error usually means the API key in your request header has expired, was revoked, or was copied incorrectly. Generate a fresh key from Mailchimp’s API Keys page, update the header in your integration, and save it again. Also confirm the data center code in your endpoint URL matches the one in your current API key, since a mismatch here causes requests to fail even with a valid key.
- Missing subscriber data
If a contact appears in Mailchimp without the details you expected, check whether the corresponding form field was actually mapped in the payload editor. An unmapped field simply isn’t sent, so it never overwrites anything, it just never arrives.
- Failed submissions
For any failed request, start with the Integration Logs entry for that submission. The API Status and API Response together usually explain the failure directly, whether that’s an invalid audience ID, a malformed payload, or a Mailchimp-side validation error on a required field like email address.
Next steps
Once this Shopify Mailchimp integration is running, the same setup pattern carries over to other tools. The API endpoint, authentication, and JSON payload mapping work the same way whether you’re connecting Shopify forms to HubSpot or sending Shopify form data to Zoho CRM, so a second integration from the same form takes far less setup time than the first one did.
If you haven’t installed the app yet, start with IPS – Contact Form to Any API from the Shopify App Store, build your form, and connect it to the Mailchimp audience where you want new contacts to land.
Frequently Asked Questions
1. Can I connect a custom Shopify form to Mailchimp without coding?
Yes. IPS – Contact Form to Any API handles this through its form builder and integration settings, without any custom backend code. You provide your Mailchimp API key and audience ID, then map your fields directly in the app’s JSON payload editor.
2. Why isn’t my Shopify form data showing up in Mailchimp?
This is almost always a mapping or authentication issue. Open Integration Logs and check the API Status and API Response for the submission in question. The most common causes are an invalid or expired API key, a data center mismatch in the endpoint URL, or a field mapped to a merge tag that doesn’t exist in your audience.
3. Do I need a Mailchimp API key to connect my form?
Yes. You’ll generate one from your Mailchimp account under Account, Extra, then API Keys, along with the audience ID for the list you want new contacts added to. Both go into the integration setup in IPS – Contact Form to Any API.
4. What happens to my form submissions if the Mailchimp integration isn’t connected yet?
Nothing is lost. Submissions are still captured and stored in the app’s Submissions section even without an integration configured, so you can finish setting up or troubleshooting the Mailchimp connection without losing any entries.
5. Is this the same as the official Mailchimp app for Shopify?
No. The official app syncs your store’s overall customer, order, and product data to Mailchimp automatically. IPS – Contact Form to Any API instead lets you build a specific custom form, like a wholesale or quote request form, and route only that form’s submissions into Mailchimp with control over exactly which fields go where.
6.How do I test that my Shopify form is correctly connected to Mailchimp?
Submit a test entry through the live form using a real email address, then check that a matching contact shows up in the correct Mailchimp audience with the fields filled in as expected. Reviewing the corresponding entry in Integration Logs confirms the request went through successfully.