Appearance
Mailchimp
Sync form submissions from UpForm to a Mailchimp audience. After contacts land in Mailchimp, you can run automations such as welcome or thank-you emails.
Before you begin
- You need a Mailchimp account.
- In UpForm, enable Save submission data for the form. Workflow sync will not run if submissions are not saved. See General.
- Mailchimp needs an email to create or update a contact. Make the form’s email field required.
- In UpForm, Mailchimp lists appear under Select audience.
- Mailchimp menus and labels can change. If something does not match exactly, use Mailchimp’s search or help for API keys, audience fields, and automations.
Connect Mailchimp in UpForm
- In UpForm, open Settings → Workflow automation.
- Click Add workflow automation provider.
- Under Select provider, choose Mailchimp.
- Enter a Title for this connection (for example,
Mailchimp). - Leave the modal open (or return after you create the key), then continue to generate an API key in Mailchimp.

Generate a Mailchimp API key
- Sign in to your Mailchimp account.
- Open your account menu, then go to Account & billing.

- Open Extras → API keys.

- Under Your API keys, click Create A Key.

- Name the key (for example,
UpForm Integration), then generate it.

- Copy the key immediately. Mailchimp typically will not show the full key again after you leave the page.

- Return to UpForm, paste the key into API key, enable Active if shown, then click Save.
Prepare audience fields
You can sync any UpForm form. The screenshots below use an example form with fields such as name, email, makeup experience, preferred style, and a notification opt-in.

Create matching audience fields in Mailchimp for any answers that do not already have a merge field.
- In Mailchimp, open your Audience.
- Go to Settings → Audience fields and merge tags.

- Click Create a new Field and choose a data type (for example, Text).


- Enter a Field name (for example,
Makeup experience) and a Merge tag (for example,EXPERIENCE), then save. - Repeat for other custom answers you want to sync (for example, makeup style and notification preference).

Enable Mailchimp on a form
- Open the form in the form builder (or create one from a template).
- Open the General tab → Workflow automation.
- Enable Sync submission data with Mailchimp.
- Select the Provider you connected earlier.
- Under Select audience, choose the Mailchimp audience you prepared.

You can also click Add for Mailchimp from this section if you have not connected a provider yet.
Map form fields
After you select an audience, the mapping table appears with Label, Name, and Mapping.

Match each form field to a Mailchimp field under Mapping. Example:
| Form field | Mailchimp field (example) |
|---|---|
| Email address | Email address |
| First name | First Name |
| Last name | Last Name |
| What is your makeup experience level? | Makeup experience |
| What is your favorite makeup style? | Makeup Style |
| Notify me when the event starts | Receive notification |
Email mapping is required. Fields left unmapped are not sent to Mailchimp.
If new audience fields do not appear in the dropdown yet, wait a moment or reconnect the Mailchimp provider so UpForm can refresh the field list.
Then Save the form and Publish it to your storefront.
Test the sync
- On the live storefront, submit the form with complete test data.

- Wait about 30–60 seconds (API sync can take a short time).
- In Mailchimp, open Audience and confirm the new contact and mapped custom fields.

Optional: Create a Mailchimp automation
After contacts sync successfully, you can automate follow-up. Example: send a welcome email when someone signs up, with optional branching by form answers.
- In Mailchimp, open Automations.
- Click Build from scratch.

- Name the automation (for example,
UpForm – Holiday Glam Live Tutorial), then choose a trigger.

- Select a signup-related trigger such as Signs up for Email, so the flow starts when a contact is added from UpForm.

- Optionally add a Time delay (for example, 1 hour).

- Optionally add an If/Else rule to branch by a custom field (for example, Makeup Style is Soft glam).

- On each path, add a Send email action with the message you want for that group.

- Review the flow, then turn it on.
If this does not work as expected, Contact for help.

