Mailchimp Integration
Gleam allows you to send email subscribers to Mailchimp. To enable this feature, you must have either the Pro plan or above.
You can connect Mailchimp on the Pro Plan & above. Go to Settings > Integrations and turn on Mailchimp.

Paste in your Mailchimp API key, then pick the default audience (list) Gleam sends subscribers to. The audience has to exist in Mailchimp first.
To make a key in Mailchimp, click your profile icon, choose Profile, then Extras > API keys > Create A Key. Mailchimp shows the full key only once, so copy it straight away. Keys made since June 2026 expire after a year (Mailchimp's API key guide), so if subscribers stop arriving, check your key first.
You can also add Mailchimp Groups or Tags if you want to sort subscribers from different campaigns.
Turning Mailchimp on in Settings isn’t enough on its own. In each campaign, open your Subscribe action and check Mailchimp is switched on under Email integrations with an audience chosen. If it’s off, nobody reaches Mailchimp.
We support the syncing of Custom Fields for Mailchimp through our Custom Field Sync feature, you can set this up via the Custom Field Mapping button when setting up the integration.
In order to send users to a list you must use the Subscribe action type.
Simply enter in the name of the corresponding list in Mailchimp you want to send users to.
Gleam supports the ability to enable double opt-in when you send contacts to a list. However we do not validate whether or not the double opt-in has been confirmed, only that the user was originally sent to Mailchimp correctly.
You must validate these users manually when picking a winner (and invalidate as necessary).
Double opt-in is a bit subjective depending on the user:
- Some users may confirm straight away
- Some may never confirm
- Some may confirm in a few hours or in a few days
This would require us to continually check the double opt-in multiple times then also display different messages in the widget depending on the status. Doing this has larger implications as we currently support over 20+ email providers, that all deal with double opt-ins in very different ways.
Gleam sends three fields to Mailchimp automatically:
- EMAIL: the entrant's email address
- FNAME: first name
- LNAME: last name
First and last name only reach Mailchimp if you collect them in your campaign, for example as fields on the Pre-Entry tab.
On the Business Plan & above, you can send anything else, such as country, company or the answer to a question. Open the Subscribe action, click Custom Field Mapping and match each Gleam field to its Mailchimp merge tag. More detail is in Custom Field Sync.
If your Mailchimp audience has other required fields, such as an address or birthday, map each one or make it optional in Mailchimp. A required field Gleam does not send blocks the sync, and that entrant never reaches your audience.
In order to test if emails successfully send to Mailchimp you need to do the following:
- Have a competition created with a Subscribe action
- Ensure that this action is linked to an existing list in Mailchimp
- Enter the action manually from your competition dashboard
- The action will become invalidated (since we automatically invalidate admin actions)
- Go to Actions / Entries for that competition, then make your action valid
- It should appear in Mailchimp within a few minutes
- Gleam automatically invalidates actions from admins (for testing purposes), check to see if the actions you performed are valid or not. Invalid actions are not sent to email providers.
- In order to avoid this we recommend testing Mailchimp in a private or incognito window with a valid email address.
- It can take a few minutes
- Did they perform an 'Email subscribe' action? Only Email subscription actions are sent to Mailchimp automatically.
- Do you have the "Require double opt-in" option enabled? If so, they only appear after they have confirmed their subscription
- Are you checking the correct list? Check your settings for your campaign first then if nothing is set check your site settings.
- Do you have other required fields that we're not sending? i.e. First Name / Last Name or address, this will cause the integration to fail.
- Do a CSV export of your campaign, edit it, and then import in to Mailchimp
- Find this under 'Account Settings' > 'Extras' > 'API Keys'
Settings for Mailchimp are available by editing your site via the dropdown in the Gleam sidebar then going to the 'Integrations' tab.
When setting your Mailchimp settings you must assign a default list to send subscribers to. You can also set a list per entry method when editing your campaign "How to enter" section.