Connect beehiiv
This article shows you how to create a beehiiv API key, connect beehiiv to PlayerMagick, add the emails a gate collects to your publication with tags, and start beehiiv automations from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need a beehiiv account and access to its API settings.
- Only the PlayerMagick account owner or an admin can connect beehiiv. See Understand team roles.
beehiiv sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in beehiiv
- Log in to beehiiv.
- Go to Settings → API.
- Click Create New API Key, name it
PlayerMagickand copy the key. - If you have more than one publication, copy the Publication ID of the one PlayerMagick should use (it starts with
pub_).
Step 2: Connect beehiiv in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool and choose beehiiv.
- Paste the key into API key.
- If you have more than one publication, paste its ID into Publication ID. Left empty, PlayerMagick uses your first publication.
- Click Test and connect.
One connection sends to one publication. To send to another publication too, connect beehiiv again with that publication's ID.
Step 3: Send a gate's leads to beehiiv
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your beehiiv connection. The Publication is the one you connected.
- Add up to 5 Tags if you like.
- Choose whether beehiiv sends its double opt-in confirmation email to new subscribers.
- Click Save destination.
- PlayerMagick never sends beehiiv's welcome email itself and never reactivates someone who unsubscribed.
- beehiiv allows 100 different tags per publication. A tag beyond that is skipped: the lead is still added, and Leads shows "Tag not added".
Start beehiiv automations from what people watch
beehiiv can start an automation for a subscriber when the automation has an Add by API trigger:
- In beehiiv, open the automation and add the trigger Add by API. Turn the automation on.
- In PlayerMagick, in Automations, add the action Start automation and choose it.
beehiiv has no way for other apps to stop an automation. To stop one, make the automation exit on a tag, and add that tag with Add tag.
Other actions for beehiiv: Add tag, Remove tag and Update a field (a custom field of your publication; date fields take dates like 2026-10-28).
Recognise viewers from your beehiiv emails
Add this to the end of the links in your beehiiv emails:
?pm_bh={{api_subscription_id}}
On beehiiv's paid plans you can add it to every link at once in your publication's settings, under custom link parameters: name pm_bh, value {{api_subscription_id}}.
Send yourself a test email and use Check a link.
PlayerMagick reads the first name from a custom field called First Name, if your publication has one.
Good to know
- Someone who unsubscribed in beehiiv is never added again. Leads shows Not added.
- Speed: beehiiv's free plan allows 30 requests a minute, so PlayerMagick sends one request every 2 seconds. A spike of sign-ups waits safely and reaches beehiiv in order.
Error messages
| Message | What to do |
|---|---|
| "beehiiv did not accept this key. Check that you copied the whole key." | Copy the key again. If you entered a Publication ID, check that it belongs to the same beehiiv account. |
| "This key can’t read your lists. Use a key of a user who can manage contacts." | The key's account has no publication yet. Create one in beehiiv. |
| "beehiiv didn’t answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.