---
title: "Integrating ManyChat with your beehiiv publication"
updated: 2026-06-01
---

# 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.

---

## What you'll need before you start

-   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](https://www.beehiiv.com/support/article/13091918395799-how-to-access-your-publication-id-or-api-keys) scoped to the publication you want ManyChat subscribers to land in (see next steps).

---

## How to generate an API key and get your publication ID

> **Tech Note**
>
> All subscribers added to your beehiiv account must have provided explicit consent to receive emails from you, in order to be in compliance with our [terms of use](https://www.beehiiv.com/tou) and [privacy policy](https://www.beehiiv.com/privacy).

1.  From the left dashboard panel, scroll down and click on [**Settings**](https://app.beehiiv.com/settings/publication/general).
2.  Under **Workspace Settings** in the left panel, click on [**API**](https://app.beehiiv.com/settings/workspace/api).
3.  Go to the **API Keys** section and click on the **Create New API Key** button.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835419287)
4.  Give the key a clear name (e.g. ManyChat), then click **Create New Key**.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835420183)
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.   
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835420311)

> **Reminder**
>
> Each unique API key is only displayed once. Be sure to store it somewhere safe before navigating away, if you lose it, you will need to generate a new one.

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.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835420695)

---

## Locating the ManyChat integration and installing it

1.  From the left dashboard panel, scroll down and click on [**Settings**](https://app.beehiiv.com/settings/publication/general).
2.  Under **Workspace Settings** in the left panel, click on [**Integrations**](https://app.beehiiv.com/settings/workspace/integrations). 
3.  Click the **Browse apps** button.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795060119)
4.  The **Available Apps** page will open. Use the search field to find ManyChat. On the ManyChat tile, click [**Learn more**](https://manychat.com/apps/3791/install). You’ll be redirected to the ManyChat app portal, where the beehiiv app is hosted.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795060247)

> **Tech Note**
>
> This integration is rolling out gradually. If you don't see the ManyChat integration as an option in your account, you can [go directly to the ManyChat app portal](https://manychat.com/apps/3791/install) and skip the steps above (must be logged into your beehiiv account).

---

## How to install the beehiiv app inside ManyChat

1.  From the [ManyChat app portal](https://manychat.com/apps/3791/install), click the [**Sign In**](http://manychat.com/apps/3791/install) button to begin the integration.   
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795061399)

> **Note**
>
> If you are not already signed into ManyChat, you'll be prompted to log in before continuing.

2.  Select the ManyChat workspace you want to connect to beehiiv.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795063959)
3.  On the confirmation screen, click **Go to App Settings**.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795065751)
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**.   
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795066391)

---

## How to add the beehiiv action to a ManyChat flow

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.

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795068951)

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.

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795069847)

### Step 1: Create a trigger

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.  
  
![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835427223)

### Step 2: Ask for the contact’s email

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._👇

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783835427863)

### Step 3: Wait for email input

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._👇

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795073047)

### Step 4: Send the download Link

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._ 🚀

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795073431)

### Step 5: Add the beehiiv action 

After the confirmation message, add an **Action** step. Select the **beehiiv** app and choose **Add Subscribe.**  
  
![18-manychat-beehiiv-node.gif](https://beehiivhelp.zendesk.com/hc/article_attachments/40882463768855)

### Step 6: Configure field mapping

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

| beehiiv Field | ManyChat value to pass over | Required |
| ------------- | --------------------------- | -------- |
| Email         | Contact Email               | Yes      |
| UTM Source    | manychat                    | Optional |
| UTM Medium    | instagram                   | Optional |
| UTM Campaign  | ebook_lead_magnet           | Optional |

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

![19-manychat-custom-fields.gif](https://beehiivhelp.zendesk.com/hc/article_attachments/40882475258135)

Be sure to click **Save** when done.

### Step 7: Preview and set live

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

![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795075351)

For guidance on previewing and testing your ManyChat automations, refer to the [ManyChat knowledge base](https://help.manychat.com/hc/en-us).

---

## Tracking and segmentation

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

```auto
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**](https://app.beehiiv.com/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.

> **Pro Tip**
>
> Use unique utm\_campaign values for each ManyChat flow (for example, 'lead-magnet-ig-comments' or 'wa-welcome') so you can compare which flows drive the highest-performing subscribers.

---

## Frequently asked questions about the ManyChat integration

**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.  
  
![](https://beehiivhelp.zendesk.com/hc/article_attachments/40783795075607)

**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.