beehiiv
Connect beehiiv to grow and manage subscribers, draft and schedule newsletter posts, track opens and clicks, and run segments and automations.
You paste one beehiiv workspace API key into PopMCP, then pick which publications to connect and the PopMCP workspace each one goes into.
Paid plan required before this connector works
No one reviews you and most of the API works on every plan, but beehiiv only lets publications on the Pro and Enterprise plans create posts through the API (the Send API). Drafting, scheduling and publishing newsletter posts from the AI needs one of those plans.
- Typical wait
- None. The post endpoints answer as soon as the publication is on Pro or Enterprise.
- Cost
- Pro and Enterprise are priced by subscriber count on beehiiv.com/pricing. beehiiv's current plans are Free, Lite, Pro and Enterprise; guides written before its 2026 rename call Pro "Max" and Lite "Scale".
- Blocked until approved
- create_post, update_post and the post template tools. Subscribers, custom fields, tags, lists, segments, automations, post stats and every other read keep working on Free and Lite.
- Works meanwhile
- Connect on any plan and use the subscriber, segment, automation and analytics tools straight away. Draft posts in the beehiiv editor until the publication moves to Pro.
Where to apply: No application. Upgrade the publication to Pro or Enterprise in beehiiv, then retry the post tools with the same API key.
- A post created through the API without a status is published and emailed immediately. PopMCP saves every create_post as a draft unless the AI asks to publish or schedule.
- The Free plan allows 30 API requests a minute per key, which is slow for bulk subscriber work. Lite allows 180, Pro 500 and Enterprise 800.
- Exports and data deletion requests also need beehiiv support to enable them, separately from the plan.
- beehiiv may ask the Owner or Admin to verify their identity with Stripe before it creates an API key.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- https://api.beehiiv.com/v2
- Rate limits
- Per API key, in fixed 60-second windows: 30 requests a minute on Free, 180 on Lite, 500 on Pro and 800 on Enterprise. A key's first request after it has been idle is held to 180. Calls over the limit get 429, and every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers.
Before you begin
- The Owner or Admin role in your beehiiv workspace. Only they can create API keys.
- Any beehiiv plan for subscribers, segments, automations and stats. Creating or updating posts through the API needs the Pro or Enterprise plan (Pro was called Max before beehiiv renamed its plans).
- Time for a quick identity check: beehiiv may ask you to verify your identity with Stripe when you create the key.
- If the key should reach only some publications, know which ones. You restrict it while creating or editing the key.
Get your credentials
Open the API page in Workspace Settings
Sign in at app.beehiiv.com, click Settings, then click API under the Workspace Settings section.
API
Workspace API keys. A key reaches every publication unless you restrict it.
| Name | Publications | Created |
|---|---|---|
| ZapierCreated by Dana Reyes | All publications | Feb 11, 2026 |
| Signup formCreated by Sam Okoye | The Weekly Brief | Jul 30, 2026 |
If you do not see Workspace Settings, ask a workspace Owner or Admin to create the key.
Create the key and choose its publications
Click Create New API Key and name it, for example PopMCP. Leave publication access open so the key reaches every publication in the workspace, or restrict it to the publications PopMCP should see. Complete the Stripe identity check if beehiiv asks for it.
API
Workspace API keys. A key reaches every publication unless you restrict it.
A restricted key answers 404 for publications outside its list, exactly as if they did not exist.
Copy the key before leaving the page
Copy the key straight away. beehiiv makes it inaccessible once you leave the page, so a lost key means creating a new one.
API
Workspace API keys. A key reaches every publication unless you restrict it.
The key is a Bearer token for the whole workspace (or its chosen publications). Treat it like a password.
Paste the key into PopMCP and pick publications
In PopMCP, paste the key into API key and click Connect beehiiv. PopMCP lists every publication the key can reach. Tick the ones to connect, choose the PopMCP workspace for each, and click the Connect button under the list.
Connect in PopMCP
Open your workspace, choose beehiiv in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | In beehiiv: Settings → Workspace Settings → API → Create New API Key (you need to be a workspace Owner or Admin). Copy it right away, beehiiv only shows it once. A key can reach every publication in the workspace, or only the ones you restrict it to. Stored encrypted and used server-side only.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against beehiiv immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows each publication as its own Verified connection labelled beehiiv · <publication name>. Asking the AI for the publication's subscriber count and average open rate returns real numbers.
Troubleshooting
401 `The api key is not valid` (code INVALID_API_KEY)
Why: The key was copied incompletely, or it was deleted in beehiiv.
Fix: Create a new key under Settings, Workspace Settings, API, copy it before leaving the page, and reconnect.
A publication is missing from PopMCP's picker
Why: The key is restricted to other publications. A restricted key cannot see the rest at all.
Fix: Edit the key in beehiiv to include that publication, or create an unrestricted key, then open the picker again.
This beehiiv API key can no longer reach the connected publication
Why: The key's publication list changed, or the publication was removed, so beehiiv answers 403 or 404 for it.
Fix: Reconnect beehiiv with a key that includes the publication.
Creating or updating a post fails while other tools work
Why: beehiiv only allows post creation through the API on the Pro and Enterprise plans.
Fix: Upgrade the publication to Pro or Enterprise, or draft the post in the beehiiv editor.
get_post returns 202 or nothing right after create_post
Why: beehiiv creates posts asynchronously, so the post can take a few seconds to appear. 404 POST_CREATION_FAILED means it will never exist.
Fix: Wait a few seconds and read it again. On POST_CREATION_FAILED, check the content and create it again.
Data deletion or export tools are refused
Why: beehiiv support has to enable exports and data deletion for your account, and a publication-restricted key gets 403 on data deletion.
Fix: Ask beehiiv support to enable the feature, and use an unrestricted key for workspace-wide deletion requests.
429 Too Many Requests
Why: The key went over its per-minute allowance, which depends on your plan (30 a minute on Free).
Fix: Wait for the 60-second window to reset and retry. Bulk subscriber work goes faster on a higher plan.
Reference
Attentive
Connect Attentive to Claude, ChatGPT and other MCP clients with PopMCP. Step-by-step API credential setup, plus fixes for common errors.
Brevo
Connect Brevo to manage contacts and lists, send email, SMS, and WhatsApp, run campaigns, and use the sales CRM. MCP setup guide for Claude and ChatGPT.