Beehiiv
Create, monetize, grow—a newsletter platform built by newsletter people.
Start for freeCategory
Works with
AI Compatible
Tools
Add Subscriber
Create a new subscriber for a publication. Use **List Custom Fields** to discover available custom field names before passing customFields. Use **Get Publication Info** to get the publication ID. Set reactivateExisting: true to re-subscribe someone who previously unsubscribed. See the documentation
Create Post
Create a new post (newsletter draft). Pass HTML content in the content parameter. The post is created as a draft by default — set status: "confirmed" to publish immediately. Use content tags to categorize the post. Use **Get Publication Info** to get the publication ID. See the documentation
Create Subscriber
Create a new subscriber. See docs
Get Post Analytics
Get aggregated analytics across all posts — open rates, click rates, unsubscribes, etc. Filter by audience (free/premium), platform (web/email), or content tags. Returns metrics: recipients, delivered, opens, unique_opens, open_rate, clicks, unique_clicks, click_rate, unsubscribes, spam_reports. Use **List Posts** to see individual post details. Use **Get Publication Info** to get the publication ID. See the documentation
Get Publication Info
Get details about the current beehiiv publication, including name, URL, and subscriber stats. **Call this first** to get the publicationId needed by all other tools. If you have multiple publications, pass the publicationId — otherwise the first publication is returned. Returns the publication name, description, URL, creation date, and subscriber count. See the documentation
Get Subscriber
Get full details for a single subscriber by ID or email. Use expand to include stats (open/click rates), custom field values, or referral data. Either subscriptionId or email must be provided. Use **Search Subscribers** to find subscriber IDs. Use **Get Publication Info** to get the publication ID. See the documentation
List All Publications
Get a list of all your publications. See docs
List Custom Fields
Schema discovery — list all custom fields defined for subscribers in a publication. Use this before **Create Subscriber** or **Update Subscriber** to know what custom fields are available and their expected types. Use **Get Publication Info** to get the publication ID. See the documentation
List Posts
List posts (newsletter issues) for a publication. Filter by status, audience, platform, or content tags. Returns post titles, dates, status, and URLs. Use **Get Publication Info** to get the publication ID. Use **Get Post Analytics** for aggregate performance metrics across posts. See the documentation
List Segments
List subscriber segments for a publication. Segments are pre-defined subscriber groups (dynamic rules, static lists, or manual selections). Use this for discovery — to understand how subscribers are organized. Use **Get Publication Info** to get the publication ID. See the documentation
Search Subscribers
Search and filter subscribers for a publication. Use email for exact email lookup, or combine status and tier filters to narrow results. Use **Get Publication Info** to get the publication ID. For full details on a single subscriber (with stats, custom fields, referrals), use **Get Subscriber** instead. Use **List Custom Fields** to discover available custom field names. See the documentation
Update Subscriber
Update an existing subscriber's fields or unsubscribe them. Use **Search Subscribers** or **Get Subscriber** to find the subscription ID first. Use **List Custom Fields** to discover available custom field names. Set unsubscribe: true to unsubscribe the subscriber. Use **Get Publication Info** to get the publication ID. See the documentation