Mailchimp chatbot integration

The Mailchimp step adds the visitor to your Mailchimp audience the moment they agree to hear from you, with their name and the tags that say where they came from, or updates them if they are already on the list.

Build on the Free plan. The Mailchimp step runs on Pro ($39/month) and above.

Builder step
Mailchimp: add or update a subscriber
How you connect
Mailchimp API key
Subscription
Subscribe now or double opt-in
Plan
Pro and above (native integrations)
Safe to repeat
Yes, the same email is updated, not duplicated
What it does

What the Mailchimp step can do

A newsletter box in the footer asks for an email with nothing in return. A chatbot can ask at the right moment, after it has answered a question or sent a discount code, and the Mailchimp step makes sure that address reaches your audience straight away instead of sitting in a spreadsheet.

The step adds or updates one subscriber at a time. It writes the email, first and last name, and any tags you choose, so a segment in Mailchimp can tell a visitor who asked about pricing from one who downloaded a guide. Run it twice for the same person and their record is updated, not duplicated.

Add or update a subscriber

The visitor's email is added to the audience you pick. If they are already on it, their record is updated with the new name and tags instead of creating a second contact.

Subscribe or double opt-in

Choose Subscribe to add the address straight away, or Double opt-in so Mailchimp emails the visitor a confirmation link first and they join only after clicking it.

Names in merge fields

First and last name are saved to Mailchimp's FNAME and LNAME merge fields, so campaigns can greet subscribers by name.

Tags for segments

Add one or more tags, such as chatbot or pricing-page. New tags are created in Mailchimp, and existing tags on the contact are kept.

Respects unsubscribes

Someone who already unsubscribed from the audience is not subscribed again by the step. Their choice stays in place.

Reference

Settings in the Mailchimp step

SettingWhat it does
AccountA Mailchimp account connected with its API key.
AudienceThe list subscribers are added to. The builder shows its contact count and whether double opt-in is on.
EmailUsually ${email}. It must be a valid address.
First name / Last nameSaved to the FNAME and LNAME merge fields. Optional.
SubscriptionSubscribe adds the address now. Double opt-in sends Mailchimp's confirmation email first.
TagsOptional tags to add. Tags are added, never removed.
Save resultThe subscriber's Mailchimp ID, for later steps.
Setup

How to connect Mailchimp to your chatbot

About five minutes. You need a Pro or higher Conferbot workspace and a Mailchimp account with an audience.

  1. 1

    Create a Mailchimp API key

    In Mailchimp, open your profile, then Extras and API keys, and create a key. It ends in your account's data centre, such as -us21, which the step uses to reach your account.

  2. 2

    Add the Mailchimp step and connect

    Drag the step into the flow, choose Connect, and paste the API key. The step checks the key and loads your audiences.

  3. 3

    Ask for consent and the email

    Before the step, ask whether the visitor wants your emails and collect the address, saved to a variable such as email. Only run the Mailchimp step on the yes branch.

  4. 4

    Pick the audience and map the fields

    Select the audience, put ${email} in Email, and map first and last name if you asked for them.

  5. 5

    Choose Subscribe or Double opt-in

    Double opt-in is the safer choice for most lists, because only people who confirm by email are added. Use Subscribe when the visitor has already confirmed in another way.

  6. 6

    Add tags and test

    Tag the source, such as chatbot plus the page or offer, then subscribe yourself in preview and check the contact and its tags in Mailchimp.

Recipes

Flows people build with Mailchimp

Discount code for a subscription

Offer a code in exchange for joining the newsletter. Subscribe the visitor with a welcome-offer tag, show the code in the chat, and let a Mailchimp automation send the welcome series.

Event and webinar sign-ups

Register attendees in the chat and add them to the event audience with the session as a tag, so reminders and follow-ups go only to the people who signed up.

Waitlists and launch lists

Collect interest before a product or service launches and tag each person with what they asked about. When it ships, send one campaign to the right segment.

Access

Permissions and access

What the API key allows

A Mailchimp API key gives access to the whole account it belongs to. Create a key for Conferbot alone, so you can revoke it without affecting other tools.

Consent stays your responsibility

The step adds the people your flow sends to it. Ask for consent in the chat, keep a record of it, and use double opt-in where your audience or local law expects it.

Disconnecting

Delete the API key in Mailchimp under Extras, API keys, and the step can no longer reach the account. Subscribers already added stay in your audience.

Good to know

Limits and behaviour to plan around

One subscriber per run

The step adds or updates the visitor in front of it. It does not import lists, send campaigns or remove contacts; do those in Mailchimp.

Unsubscribed contacts are not re-added

The subscription choice only applies to people who are new to the audience. Someone who unsubscribed earlier keeps that status even if they give their email in the chat again.

Tags never removed

Tags are added to the contact and existing tags are left alone. If a tag cannot be applied, the subscriber is still added and the problem is logged.

A failed call does not stop the chat

An invalid email, a missing audience or a rejected key means no subscriber is added; the conversation continues and the result variable stays empty.

Troubleshooting

Fixing common Mailchimp problems

What you seeWhy, and the fix
"Mailchimp rejected this API key"The key was deleted or mistyped. Create a new key in Mailchimp under Extras, API keys, and reconnect.
No audiences in the listChoose the account first, then refresh. If it is still empty, create an audience in Mailchimp.
"The email variable is empty"The step ran before the email question, or the variable name differs. Move the step after the question and check the name.
The visitor is not on the listWith Double opt-in they join only after clicking Mailchimp's confirmation email. Check the pending contacts, or use Subscribe if consent is already confirmed.
A returning visitor was not subscribedThey had unsubscribed before. The step never overrides an unsubscribe; they can rejoin through a Mailchimp signup form.
FAQ

Mailchimp integration: common questions

Can a chatbot add subscribers to Mailchimp?

Yes. The Mailchimp step adds the visitor's email to the audience you choose, with first and last name and tags, or updates them if they are already on it.

Does it support double opt-in?

Yes. Choose Double opt-in and Mailchimp emails the visitor a confirmation link; they are added once they click it.

Will it create duplicate contacts?

No. Mailchimp identifies a contact by email, and the step updates the existing contact when the email is already in the audience.

Can I tag subscribers by where they signed up?

Yes. Add tags in the step, such as the page or offer. New tags are created in Mailchimp and existing tags are kept.

How do I connect Mailchimp?

Create an API key in Mailchimp under Extras, API keys, then paste it into the step. The key tells the step which Mailchimp data centre your account uses.

What if the visitor already unsubscribed?

The step leaves them unsubscribed. It never re-subscribes someone who opted out.

Can it send campaigns or remove contacts?

No. The step adds or updates one subscriber. Campaigns, automations and removals are done in Mailchimp.

Which plan includes Mailchimp?

Mailchimp is a native integration, included on Pro and above. You can build and preview the flow on any plan.

Does it work on WhatsApp and Instagram?

Yes. The step runs on the server, so any channel where the flow collects an email can add the subscriber.

Turn chat conversations into newsletter subscribers

Start free with Conferbot - the free plan includes 600 conversations a month and needs no credit card, so you can build the signup flow today. The Mailchimp step switches on with Pro.

Checked against Conferbot's product and Mailchimp's documentation on November 3, 2026: Mailchimp Marketing API: add or update list member, Mailchimp: about API keys, Mailchimp: about double opt-in.

Guides for Mailchimp flows

Guides on growing a list and turning chats into leads.