Integrating ManyChat with your beehiiv publication

ManyChat is a chat marketing platform that lets you automate conversations across Instagram, Facebook Messenger, and WhatsApp. With the beehiiv integration, any contact who provides their email through a ManyChat flow is automatically added to your beehiiv publication as a subscriber, no manual exports or imports needed.

This article covers everything you need to get the integration set up: generating your beehiiv API key, installing the beehiiv app inside ManyChat, building a flow that captures emails and passes them to beehiiv, and using UTM parameters to track where your subscribers are coming from.

• An active beehiiv account where you are an Admin.
• A paid ManyChat plan, with your Instagram, Facebook, or WhatsApp channel already connected inside ManyChat; integrations are not available on ManyChat's free tier.
• A beehiiv API key scoped to the publication you want ManyChat subscribers to land in (see next steps).

1. From the left dashboard panel, scroll down and click on Settings.
2. Under Workspace Settings in the left panel, click on API.
3. Go to the API Keys section and click on the Create New API Key button.
   
   
   
4. Give the key a clear name (e.g. ManyChat), then click Create New Key.
   
   
   
5. A module with a Unique API Key will open. Click Copy to add the API key to your clipboard and save it, you'll need it shortly in the install steps. When done, click I’ve saved the key to confirm. 
   
   
   

6. Scroll down the API page to Publication ID. Copy your API V2 Publication ID and save it, you'll also need this in the install steps.
   
   
   

1. From the left dashboard panel, scroll down and click on Settings.
2. Under Workspace Settings in the left panel, click on Integrations. 
3. Click the Browse apps button.
   
   
   
4. The Available Apps page will open. Use the search field to find ManyChat. On the ManyChat tile, click Learn more. You’ll be redirected to the ManyChat app portal, where the beehiiv app is hosted.
   
   
   

1. From the ManyChat app portal, click the Sign In button to begin the integration. 
   
   
   

2. Select the ManyChat workspace you want to connect to beehiiv.
   
   
   
3. On the confirmation screen, click Go to App Settings.
   
   
   
4. You’ll need your beehiiv API Key and V2 Publication ID for this step, so have them ready. Under App Setup, enter your API Key and Publication ID into their respective fields. Confirm both are correct, then click Save. 
   
   
   

Once the beehiiv app is installed in ManyChat, you can add a beehiiv action to any flow that collects a contact's email address. The steps below walk through a sample flow using an Instagram comment trigger, but the same approach applies to Facebook Messenger and WhatsApp flows.

Inside ManyChat, you can use their ‘Grow Email List’ automation template to get started quickly, or build your own flow from scratch. The steps below walk through a sample Instagram comment trigger flow that:

• Triggers when a user sends a keyword (for example, ebook).
• Asks for the contact's email address.
• Sends the promised download link.
• Adds the contact to your beehiiv publication.

In ManyChat, set your trigger to match your use case. Options include: a user sending a message, commenting on a post or reel, or clicks a referral link. In this example, the keyword is ebook, so anyone who messages or comments with that word will enter the flow.

Add a message explaining what the user will receive and asking them to enter their email address. Enable User Input and set the expected response type to Email.

Example email message:

Hi! Thanks for reaching out.
We’re excited you’re interested in our free ebook.
Please enter your email below and we’ll send it right over.👇

ManyChat pauses the flow until the contact submits their email. You can add a reminder message to follow up if they don't respond.

Example reminder message:

Hi! Are you still interested in getting the free ebook?
Drop your email below and we’ll send it right over.👇

After the email is captured, send a confirmation message with your resource link. Include a button linking to your ebook, landing page, or website.

Example confirmation message:

Awesome! You’re all set.
Click the link below to grab your ebook. 🚀

After the confirmation message, add an Action step. Select the beehiiv app and choose Add Subscribe.

Map your ManyChat fields to beehiiv. Email is the only required field. 

UTM fields are optional but recommended for segmentation, as seen in the example below.

Be sure to click Save when done.

Click Preview to see how the flow runs, then click Set Live in ManyChat.

For guidance on previewing and testing your ManyChat automations, refer to the ManyChat knowledge base.

beehiiv automatically captures the following UTM and acquisition fields when you pass them through from ManyChat:

utm_source, utm_medium, utm_campaign, utm_term, utm_content, referrer, referring_domain, and landing_page.

You can build segments using any of these fields at Subscribers > Segments. A common pattern is to create a segment called 'From ManyChat, Instagram' filtered to utm_source = manychat and utm_medium = instagram, then use that segment for targeted sends or to measure performance against subscribers from other channels.

Why aren't my ManyChat subscribers appearing in beehiiv?
Double-check the API key you pasted into ManyChat. If the key is missing or has an extra space, the action will fail silently. Also confirm you are using the API V2 Publication ID in your ManyChat app settings.



Why are my subscribers showing up with no UTM data?
UTM fields are only populated from values you explicitly map inside ManyChat. If you did not pass any UTM fields in your flow, beehiiv will not have those values recorded. Edit the beehiiv action in ManyChat, add your static UTM values, and test again.
What happens if a subscriber already exists in beehiiv?
If the email address already exists in your publication, beehiiv will not create a duplicate. The existing subscriber record is retained as-is. If you want to reactivate an unsubscribed contact, you would need to handle that separately; the ManyChat integration does not override a contact's unsubscribed status.
Does this integration work with all ManyChat channels?
The beehiiv action is available across all ManyChat channels where email collection is supported — Instagram, Facebook Messenger, and WhatsApp. The setup steps are the same regardless of which channel your flow uses; only the trigger configuration will differ.