Connect beehiiv

Updated Oct 26, 2026 · 4 min read · Pro, Business and Agency plans

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

  1. Log in to beehiiv.
  2. Go to Settings → API.
  3. Click Create New API Key, name it PlayerMagick and copy the key.
  4. 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

  1. Go to Settings → Integrations.
  2. Click Connect an email tool and choose beehiiv.
  3. Paste the key into API key.
  4. If you have more than one publication, paste its ID into Publication ID. Left empty, PlayerMagick uses your first publication.
  5. 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

  1. Open your video, click the Interactions tab and click the email gate.
  2. Under Send leads to, choose your beehiiv connection. The Publication is the one you connected.
  3. Add up to 5 Tags if you like.
  4. Choose whether beehiiv sends its double opt-in confirmation email to new subscribers.
  5. 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:

  1. In beehiiv, open the automation and add the trigger Add by API. Turn the automation on.
  2. 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

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

Was this article helpful?