> ## Documentation Index
> Fetch the complete documentation index at: https://formsplugin.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Beehiiv

> Connect Beehiiv with Framer Forms using the Forms Plugin to automatically add form submissions to your Beehiiv publication.

# Connect Beehiiv with Framer Forms

Capture leads from your Framer forms and automatically add them to your Beehiiv publication using the Forms Plugin.

***

## Step 1 - Get Your Beehiiv API Key and Publication ID

Before connecting Beehiiv to your form, get your API key and Publication ID from your Beehiiv account. These allow the Forms Plugin to securely send form submissions to Beehiiv.

<Frame>
  <img src="https://mintcdn.com/formsplugin/nuH6w9HyT7O56VW4/images/screenshots/integrations/beehiiv/beehiiv-step1-api-key.png?fit=max&auto=format&n=nuH6w9HyT7O56VW4&q=85&s=db13dbf4dd312f32087da931a17dfb59" alt="Beehiiv account showing the API settings page" width="1950" height="1188" data-path="images/screenshots/integrations/beehiiv/beehiiv-step1-api-key.png" />
</Frame>

1. Login to your Beehiiv account
2. Navigate to **Settings** → **Integrations** → **API**
3. Generate a new **API Key**
4. Copy the generated API key
5. Note your **Publication ID** (visible in your Beehiiv settings)

<Tip>
  Keep your API key in a secure password manager. Never share it publicly or commit it to a code repository.
</Tip>

***

## Step 2 - Insert Beehiiv Component Into Your Form

Select your form in the Framer canvas and insert the Beehiiv component.

The component connects your form to Beehiiv and automatically detects the form fields in your form layout.

<Frame>
  <img src="https://mintcdn.com/formsplugin/nuH6w9HyT7O56VW4/images/screenshots/integrations/beehiiv/beehiiv-step2-insert-component.png?fit=max&auto=format&n=nuH6w9HyT7O56VW4&q=85&s=f0d26e3f10173331282c75641d0bb6c5" alt="Forms Plugin panel in Framer showing the Beehiiv Integrations screen with the Insert Beehiiv Component button" width="1910" height="1296" data-path="images/screenshots/integrations/beehiiv/beehiiv-step2-insert-component.png" />
</Frame>

***

## Step 3 - Configure Beehiiv API Settings

After inserting the Beehiiv component, configure the API settings in the component properties panel.

<Frame>
  <img src="https://mintcdn.com/formsplugin/nuH6w9HyT7O56VW4/images/screenshots/integrations/beehiiv/beehiiv-step3-api-settings.png?fit=max&auto=format&n=nuH6w9HyT7O56VW4&q=85&s=77ae4d8719fc7955bc66ce5c8c99b1f9" alt="Framer canvas with Beehiiv component selected showing the API Settings modal" width="1693" height="1320" data-path="images/screenshots/integrations/beehiiv/beehiiv-step3-api-settings.png" />
</Frame>

1. Select the **Beehiiv Integration** component in your form
2. Open the properties panel on the right side
3. Paste your **Beehiiv API Key**
4. Enter your **Publication ID**

### Required Fields

* **API Key** - Paste the API key generated from your Beehiiv account.
* **Publication ID** - Enter your Beehiiv Publication ID.

***

## Step 4 - Configure Field Mapping

Map your form fields to Beehiiv subscriber attributes.

The component automatically detects your form field names. You simply connect each field to the correct Beehiiv attribute.

<Frame>
  <img src="https://mintcdn.com/formsplugin/nuH6w9HyT7O56VW4/images/screenshots/integrations/beehiiv/beehiiv-step4-field-mapping.png?fit=max&auto=format&n=nuH6w9HyT7O56VW4&q=85&s=12e44c7c41e86d4f8e5c81ca81786164" alt="Framer canvas showing the Mappings modal with form fields mapped to Beehiiv attributes" width="1682" height="1311" data-path="images/screenshots/integrations/beehiiv/beehiiv-step4-field-mapping.png" />
</Frame>

### Example Mapping

| Form Field | Beehiiv Attribute |
| ---------- | ----------------- |
| email      | email             |

Beehiiv primarily uses email for subscriptions. Optional custom fields can be configured within your Beehiiv publication settings.

***

## Step 5 - Result

When a user submits the form, their details will automatically be added as a subscriber to your Beehiiv publication. You can verify new subscribers in your Beehiiv Dashboard under **Audience** → **Subscribers**.

<Frame>
  <img src="https://mintcdn.com/formsplugin/nuH6w9HyT7O56VW4/images/screenshots/integrations/beehiiv/beehiiv-step5-result.png?fit=max&auto=format&n=nuH6w9HyT7O56VW4&q=85&s=200480728fa69c265d4285e0f97d083d" alt="Completed Beehiiv integration on a form with Integration active status" width="1617" height="1237" data-path="images/screenshots/integrations/beehiiv/beehiiv-step5-result.png" />
</Frame>

## Next Steps

* [Integrations Overview](/integrations/overview)
* [Contact Support](https://go.formsplugin.com/contact) if you need help
