beehiiv

Overview

The Advanced Form Integration (AFI) plugin lets you connect your WordPress forms to beehiiv, enabling automatic subscriber addition to your beehiiv publication. When someone fills out a form on your website, the data is sent instantly to your beehiiv account to subscribe them to a publication.

This is perfect for growing your newsletter audience directly from your site.

---

Supported Features

• ✅ Subscribe users to a selected beehiiv publication

---

How To Setup

Step 1: Connect Your beehiiv Account

Before you can create an integration, you must save your beehiiv API key.

1. Go to AFI > Settings > General

2. Enable beehiiv from the platform list and click Save Changes

3. A new beehiiv tab will appear at the top — click on it

4. Enter your beehiiv API Key

How to Get Your API Key:

• Log into your beehiiv account

• Go to Account Settings > Advanced

• Copy your API Key and paste it into the plugin settings

Click Save Changes to complete the connection.

---

Step 2: Create New Integration

1. Go to AFI > Add New

2. You’ll land on the New Integration setup screen

Title

Provide a meaningful title, like “Subscribe to Newsletter (beehiiv)”, to easily identify this integration later.

Trigger

• Form Provider: Choose your form plugin (e.g., Contact Form 7, WPForms, Elementor, etc.)

• Form/Task Name: Select the form you want to connect with beehiiv

---

Step 3: Configure the Action

Platform

Select beehiiv

Task

Select Subscribe To Publication

This will subscribe the form submitter to your selected beehiiv publication.

---

Step 4: Map Fields

After selecting the task, the following options will appear:

Select Publication (Sequence)

• The plugin will fetch your available beehiiv publications

• Select the publication you want to add the user to

Subscriber Fields

You can map the following optional fields:

• Email (required)

• utm_source

• utm_campaign

• utm_medium

• referring_site

Each left-hand field represents a beehiiv field, and the right-hand dropdown lets you map it with a field from your form.

---

Step 5: Save Integration

Click Save Integration at the bottom of the page.

Your beehiiv connection is now ready! Form submissions will begin subscribing users to the selected publication.

---

Troubleshooting

If the integration is not working as expected:

1. Go to AFI > Log

2. Look for the request related to beehiiv

3. Check:

   • Was the correct data sent?

   • Was a publication selected?

   • Did beehiiv return an error?

Make sure:

• The API key is correct

• The selected publication exists and accepts subscriptions

• Email field is always filled