Connect Gravity Forms to Beehiiv
Connect Gravity Forms to Beehiiv and every form submission becomes a subscriber in the publication you choose. The free ClickSyncr for Beehiiv plugin adds a native Gravity Forms feed add-on: connect your API key once, pick a publication, map your fields, save. So there is no code, and it takes about two minutes per form.
Before you begin
You need three things: the ClickSyncr for Beehiiv plugin activated, Gravity Forms active, and a Beehiiv account with permission to create an API key. You store the key once, and every supported builder on the site then shares it.
Get your Beehiiv API key
- Log in to Beehiiv and go to Settings → Integrations (app.beehiiv.com/settings/integrations).
- Create a new API key and give it a recognisable name such as
WordPress ClickSyncr. - Copy it and paste it into any ClickSyncr Beehiiv panel. One key serves the whole site.
Treat the key like a password. Anyone holding it can read and modify your Beehiiv subscribers.
Gravity Forms setup, step by step
- Open the form’s settings and find ClickSyncr Beehiiv. From Forms, edit a form and open Settings. ClickSyncr Beehiiv appears in the settings menu as a feed add-on, the same pattern as every Gravity Forms integration.
- Create a feed and connect your Beehiiv API key. Also, you store the key once for the whole site, so other forms and builders then share the connection.
- Choose the Beehiiv publication. In fact, the publication list loads from your account with subscriber and field counts.
- Map your form fields. Then the feed’s field map pairs Gravity Forms fields with Email (required) and the publication’s custom fields.
- Optional: set a consent field. Also, select a checkbox field so only opted-in visitors arrive as Active subscribers; the rest are stored as Unconfirmed.
- Save the feed. In addition, every submission that passes the feed now syncs.
Email and custom fields
Beehiiv identifies subscribers by email, so Email is the one required mapping. Every other row maps to your publication’s custom fields, which ClickSyncr loads automatically once the key connects. Custom fields are per publication in Beehiiv; before you pick a publication the list shows the union across your account. Also, ClickSyncr simply skips an unmapped field and never overwrites existing subscriber data with a blank value.
Subscriber status and double opt-in
Each form chooses a subscriber status: Active, Unconfirmed, or Use publication setting, which defers to your publication’s own opt-in behaviour. A consent field overrides it per submission: ticked syncs Active, unticked Unconfirmed. Beehiiv deduplicates by email, so it reactivates and updates existing subscribers instead of duplicating them.
Verify the sync
First, submit the form on the front end (not the admin preview) with a test address you can recognise, filling every mapped field. Then, in Beehiiv, open your publication’s subscriber list and confirm the subscriber exists with the mapped values and the status you expect. In short, that one minute catches almost every configuration mistake.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
| The publication dropdown is empty | The key is missing or mistyped, or you revoked it in Beehiiv. Re-paste it and reconnect. A key with a trailing space is the classic culprit. |
| Submissions do not appear in Beehiiv | Nine times out of ten the Email field is not mapped. It is the one required mapping. Fix it, then submit a fresh test. |
| A new publication or custom field is not listed | The catalog is cached briefly. Use the refresh control in the Gravity Forms settings. |
| The subscriber syncs but a field is empty | Either that field is unmapped, or it was blank on the submission. ClickSyncr skips empty values, so they never wipe existing Beehiiv data. |
| A subscriber shows as Unconfirmed | The consent field was unticked, or the form’s status is set to Unconfirmed. Check the consent mapping first. |
Is this a Gravity Forms feed add-on?
Yes. ClickSyncr for Beehiiv registers a standard Gravity Forms feed add-on, so feeds behave exactly like the Gravity Forms integrations you already know.
Do I need a specific Gravity Forms license?
Any license tier works. The plugin only needs Gravity Forms itself active on the site.
Other form builders
ClickSyncr for Beehiiv also connects Contact Form 7 · WPForms · Ninja Forms · Fluent Forms · Formidable Forms · Forminator. Overview, features and pricing: Beehiiv integration for WordPress. Browse all ClickSyncr integrations.
“Beehiiv” is a trademark of its respective owner. ClickSyncr for Beehiiv is an independent integration and is not affiliated with, endorsed by, or sponsored by Beehiiv.