Integration

beehiiv integration

beehiiv is a newsletter platform. Manage a publication's subscribers (create, look up by id or email, update, tag, delete, bulk create and bulk update, export), custom fields, segments, tiers, newsletter lists and automations; create, update, list and test-send posts and read their stats; read authors, polls and responses, podcasts and episodes, engagement, the referral program, ad network offers and reports; and manage webhooks and data deletion requests. Beta families (paid recommendations, workspace publication fields and workspace post templates), private podcast feed links, the support-gated publication duplication and the OAuth-only identify route are not exposed. Authentication is a workspace API key (Settings, then API) sent as a Bearer token; a key can be restricted to some publications.

Connect beehiiv How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in beehiiv.Built from the 97 beehiiv tools below, on the connection you add once.

What you can do with beehiiv

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Subscription, 13 operations

bulk_update_subscription_statusBulk update subscription statusPUTBulk update subscriptions' status.
create_newsletter_list_subscriptionCreate newsletter list subscriptionPOSTEnrolls an existing subscription in a newsletter list, identified by subscription_id or email. To create a new subscriber and enroll it in one call, use create_subscription with newsletter_list_ids.
create_subscriptionCreate subscriptionPOSTCreate new subscriptions for a publication.
create_subscription_exportCreate subscription exportPOSTStarts a subscriber-list export and returns the export object; read it with get_subscription_export until its status is completed. Gated: beehiiv support must enable Subscription Export API access first.
delete_subscriptionDelete subscriptionDELETEPermanently deletes a subscription and all its data; this cannot be undone, and a deleted premium subscriber is no longer billed. beehiiv recommends unsubscribing instead (update_subscription with unsubscribe true).
get_newsletter_list_subscriptionGet newsletter list subscriptionGETRetrieve a single newsletter list subscription.
get_subscriptionGet subscriptionGETReturns one subscription by its prefixed id. Use expand[] to add stats, custom fields, referrals, tags or newsletter lists.
get_subscription_exportGet subscription exportGETReturns one subscriber-list export. Once its status is completed, download_url links to the CSV file. Gated: beehiiv support must enable Subscription Export API access for the publication first.
list_newsletter_list_subscriptionsList newsletter list subscriptionsGETList all subscriptions for a newsletter list.
list_subscription_exportsList subscription exportsGETLists the publication's subscriber-list exports, newest first. Gated: beehiiv support must enable Subscription Export API access for the publication first.
list_subscriptionsList subscriptionsGETLists a publication's subscriptions, filterable by status, tier, premium tier and exact email. Paginate with cursor and next_cursor (limit up to 100); page-based paging is deprecated and capped at 100 pages.
update_newsletter_list_subscriptionUpdate newsletter list subscriptionPATCHUpdate a newsletter list subscription. Currently supports unsubscribing a subscription from a newsletter list.
update_subscriptionUpdate subscriptionPUTUpdate a single subscription.

Custom field, 5 operations

create_custom_fieldCreate custom fieldPOSTCreate a custom field on a publication, for use in subscriptions.
delete_custom_fieldDelete custom fieldDELETEDelete a custom field from a publication.
get_custom_fieldGet custom fieldGETView a specific custom field on a publication.
list_custom_fieldsList custom fieldsGETList all custom fields on a publication.
update_custom_fieldUpdate custom fieldPUTUpdate a custom field on a publication.

Newsletter list, 5 operations

create_newsletter_listCreate newsletter listPOSTCreate a new newsletter list for a publication. The list will be created with an active status. The slug will be auto-generated from the name if not provided.
delete_newsletter_listDelete newsletter listDELETEDelete a newsletter list belonging to a specific publication. The list and its subscriptions are removed in the background, so the list can still be returned until the deletion finishes.
get_newsletter_listGet newsletter listGETRetrieve a single newsletter list belonging to a specific publication.
list_newsletter_listsList newsletter listsGETList all newsletter lists for a publication.
update_newsletter_listUpdate newsletter listPATCHUpdate a newsletter list belonging to a specific publication.

Post, 5 operations

create_postCreate postPOSTCreates a post in a publication (Pro and Enterprise plans only). Posts are built asynchronously: right after creation get_post can answer 202 with a Retry-After header until the post exists.
delete_postDelete postDELETEDelete or Archive a post. Any post that has been confirmed will have it's status changed to `archived`. Posts in the `draft` status will be permanently deleted.
get_postGet postGETRetrieve a single Post belonging to a specific publication. Posts created via the Send API are built asynchronously, so a recently created post may not exist yet.
list_postsList postsGETRetrieve all posts belonging to a specific publication. Expanded content is served from a render cache.
update_postUpdate postPATCHUpdates an existing post: only the fields sent change, all others stay as they are. Pro and Enterprise plans only.

Webhook, 5 operations

create_webhookCreate webhookPOSTCreate a new webhook for a given publication.
delete_webhookDelete webhookDELETEDelete a webhook subscription from a publication.
get_webhookGet webhookGETRetrieve a specific webhook belonging to a publication.
list_webhooksList webhooksGETRetrieve all webhooks belonging to a specific publication.
update_webhookUpdate webhookPATCHUpdate a webhook subscription for a publication.

Segment, 4 operations

create_segmentCreate segmentPOSTCreate a new segment. Manual segments, Use `subscriptions` or `emails` input to create a segment from an explicit list of subscription IDs or email addresses. The segment is processed synchronously and returns with `status: completed`.
delete_segmentDelete segmentDELETEDelete a segment. Deleting the segment does not effect the subscriptions in the segment.
get_segmentGet segmentGETRetrieve information about a specific segment belonging to a publication
list_segmentsList segmentsGETRetrieve information about all segments belonging to a specific publication

Tier, 4 operations

create_tierCreate tierPOSTCreate a new tier for a publication.
get_tierGet tierGETRetrieve a single tier belonging to a specific publication
list_tiersList tiersGETRetrieve all tiers belonging to a specific publication
update_tierUpdate tierPUTUpdate an existing tier belonging to a specific publication

Deletion request, 3 operations

create_deletion_requestCreate deletion requestPOSTRequests deletion of one subscriber's data, by email, across every publication of the workspace: redacted after a 14-day safety delay, irreversible once processing starts. Gated: support must enable it; publication-restricted keys get 403.
get_deletion_requestGet deletion requestGETReturns one data deletion request and its current status. Gated: beehiiv support must enable Data Deletion API access first, and a key restricted to specific publications gets 403.
list_deletion_requestsList deletion requestsGETLists the workspace's data deletion requests. Gated: beehiiv support must enable Data Deletion API access first, and a key restricted to specific publications gets 403 (deletion requests apply to the whole workspace).

Journey, 3 operations

add_subscription_to_automationAdd subscription to automationPOSTAdd an existing subscription to an automation flow. Requires the automation to have an active *Add by API* trigger. The specified `email` or `subscription_id` will be matched against your existing subscribers.
get_automation_journeyGet automation journeyGETRetrieve a single automation journey by ID.
list_automation_journeysList automation journeysGETRetrieve a list of automation journeys that have occurred within a specific automation.

Post template, 3 operations

create_post_templateCreate post templatePOSTCreates a post template; posts created from it start with its content and settings. Content is optional: pass blocks or body_content, never both. Pro and Enterprise plans only.
get_post_templateGet post templateGETRetrieve a single post template, including the settings posts built from it start with and, on request, its rendered HTML.
list_post_templatesList post templatesGETRetrieve a list of post templates available for the publication.

Author, 2 operations

get_authorGet authorGETRetrieve a single author from a publication.
list_authorsList authorsGETRetrieve a list of authors available for the publication.

Automation, 2 operations

get_automationGet automationGETRetrieve a single automation for a publication.
list_automationsList automationsGETRetrieve automations for a publication.

Bulk subscription update, 2 operations

get_bulk_subscription_updateGet bulk subscription updateGETReturns a single Subscription Update object for a publication.
list_bulk_subscription_updatesList bulk subscription updatesGETReturns a list of Subscription Update objects for a publication.

By email, 2 operations

get_subscription_by_emailGet subscription by emailGETReturns the subscription of one email address in a publication. Use expand[] to add stats, custom fields, referrals, tags or newsletter lists.
update_subscription_by_emailUpdate subscription by emailPUTUpdate a single subscription by email.

Complimentary access, 2 operations

get_complimentary_accessGet complimentary accessGETRetrieve a single complimentary access object belonging to a specific publication.
list_complimentary_accessList complimentary accessGETRetrieve all complimentary access objects belonging to a specific publication.

Condition set, 2 operations

get_condition_setGet condition setGETRetrieve a single active dynamic content condition set for a publication. Use `expand[]=stats` to calculate and return the active subscriber count synchronously.
list_condition_setsList condition setsGETRetrieve all active condition sets for a publication. Condition sets define reusable audience segments for targeting content to specific subscribers. Use the `purpose` parameter to filter by a specific use case.

Episode, 2 operations

get_podcast_episodeGet podcast episodeGETRetrieve a single episode belonging to a specific podcast.
list_podcast_episodesList podcast episodesGETRetrieve all episodes belonging to a specific podcast.

Import, 2 operations

get_newsletter_list_importGet newsletter list importGETRetrieve the progress of the most recent subscriber import for a newsletter list. A completed import is available for 15 minutes and a failed import for 3 days. After that, this endpoint returns 404.
import_subscriptions_into_newsletter_listImport subscriptions into newsletter listPOSTAdd a publication's existing subscribers to a newsletter list in the background. With no body, every active subscriber is added.

Offer, 2 operations

accept_ad_offerAccept ad offerPOSTDraft and accept an ad offer, then insert the resulting advertisement opportunity into a post.
list_ad_offersList ad offersGETRetrieve a list of ad offers available for the publication.

Podcast, 2 operations

get_podcastGet podcastGETRetrieve a single podcast belonging to a specific publication.
list_podcastsList podcastsGETRetrieve all podcasts belonging to a specific publication.

Poll, 2 operations

get_pollGet pollGETRetrieve detailed information about a specific poll belonging to a publication. Use `expand[]=stats` for aggregate vote counts, or `expand[]=poll_responses` for individual subscriber responses.
list_pollsList pollsGETRetrieve all polls belonging to a specific publication. Poll choices are always included. Use `expand[]=stats` to include aggregate vote counts per choice.

Publication, 2 operations

get_publicationGet publicationGETRetrieve a single publication
list_publicationsList publicationsGETRetrieve all publications associated with your API key.

Summary, 2 operations

get_account_ad_network_summaryGet account ad network summaryGETRetrieve one account-wide aggregate of advertisement performance and revenue across accessible publications.
get_ad_network_summaryGet ad network summaryGETRetrieve aggregate advertisement performance and revenue for a publication.

Tag, 2 operations

add_subscription_tagsAdd subscription tagsPOSTAdds tags to a subscription. If the tag does not exist on the publication, it will be created automatically.
remove_subscription_tagsRemove subscription tagsDELETERemoves tags from a subscription. Does not delete the tag from the publication.

Advertisement, 1 operation

list_ad_offer_advertisementsList ad offer advertisementsGETRetrieve the active text advertisement creatives available for an ad offer.

Advertisement opportunity, 1 operation

list_advertisement_opportunitiesList advertisement opportunitiesGETRetrieve a list of accepted advertisement opportunities for the publication.

Aggregate stat, 1 operation

get_posts_aggregate_statsGet posts aggregate statsGETRetrieve aggregate stats for all posts. The `clicks` breakdown returns the top 1,000 URLs by total clicks across the matched posts, and URLs that differ only by a per-subscriber UUID (polls, preference pages, etc.) are grouped into a single row.

Bulk action, 1 operation

bulk_update_subscriptionsBulk update subscriptionsPUTBulk update multiple subscriptions fields, including status, custom fields, and tiers.

Bulk subscription, 1 operation

bulk_create_subscriptionsBulk create subscriptionsPOSTCreate new subscriptions for a publication.

By subscription email, 1 operation

list_publications_by_subscription_emailList publications by subscription emailGETRetrieve all publications in the workspace that have a subscription for the specified email address. The workspace is determined by the provided API key.

By subscription id, 1 operation

update_newsletter_list_subscription_by_subscription_idUpdate newsletter list subscription by subscription idPATCHUpdate a newsletter list subscription by subscription ID. An alternative to the update endpoint when you don't have the newsletter list subscription ID. Accepts either a subscription_id or email to identify the subscription.

Email, 1 operation

list_automation_emailsList automation emailsGETRetrieve all emails belonging to a specific automation, including engagement statistics for each email.

Engagement, 1 operation

get_engagementsGet engagementsGETRetrieve email engagement metrics for a specific publication over a defined date range and granularity. By default, the endpoint returns metrics for the past day, aggregated daily. The max number of days allowed is 31. All dates and times are in UTC.

Identify, 1 operation

get_workspaceGet workspaceGETRetrieve information about the workspace the OAuth or API token is associated with.

Member, 1 operation

list_segment_membersList segment membersGETList all members in a segment with full subscription data. Each member is returned as a subscription object containing complete subscriber information and their subscription details.

Permission, 1 operation

get_workspace_permissionsGet workspace permissionsGETRetrieve the permissions granted to the OAuth or API token for this workspace. API keys return all granular OAuth scopes. OAuth tokens return only the scopes they were authorized for.

Preview, 1 operation

get_post_preview_urlGet post preview urlGETGenerate a URL to preview a post as a given audience. The returned `preview_url` renders the post in the beehiiv app and requires a beehiiv session with access to the publication - it is not itself an HTML-returning endpoint.

Recalculate, 1 operation

recalculate_segmentRecalculate segmentPUTRecalculates a specific segment belonging to a publication

Referral program, 1 operation

get_referral_programGet referral programGETRetrieve details about the publication's referral program, including milestones and rewards.

Report, 1 operation

list_ad_network_reportsList ad network reportsGETRetrieve advertisement performance and payment reports for the publication.

Response, 1 operation

list_poll_responsesList poll responsesGETRetrieve all individual subscriber responses for a specific poll with cursor-based pagination. Use this endpoint for large datasets instead of the `expand[]=poll_responses` parameter on the poll show endpoint.

Result, 1 operation

list_segment_subscription_idsList segment subscription idsGETList subscriber IDs for a segment. Returns a lightweight array of subscription IDs only, without additional subscriber details.

Test send, 1 operation

send_post_test_emailSend post test emailPOSTSend a test email for a specific post to one or more email addresses. Returns the number of remaining test sends for the day and the time at which the limit resets.

Use beehiiv from Claude Code, Cursor or Codex

Connect beehiiv in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its beehiiv operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect beehiiv

Create your workspace
Sign up free. Nothing to install.
Connect beehiiv once
Add your beehiiv connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.