Connect Beehiiv to Twilio SendGrid

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 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 a new subscriber. See docs

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

Get a list of all your publications. See docs

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 (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 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 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 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

Allows you to add one or more email addresses to the global suppressions group. See the docs here

Adds or updates a contact. See the docs here

Allows you to create a new contact list. See the docs here

Create a single send. See the docs here

Allows you to delete all email addresses on your blocks list. See the docs here

Allows you to delete all emails on your bounces list. See the docs here

Allows you to delete one or more contacts. See the docs here

Allows you to remove an email address from the global suppressions group. See the docs here

Allows you to delete a specific contact list. See the docs here

Gets a specific block. See the docs here

Gets a global suppression. See the docs here

Allows you to get all of your bounces. See the docs here

Allows you to get details of your contact lists. See the docs here

Retrieves available options for the ASM Group ID field.

Retrieves available options for the ASM Groups to Display field.

Allows you to list all email addresses that are currently on your blocks list. See the docs here

Retrieves available options for the Categories field.

Retrieves available options for the Design Id field.

Retrieves available options for the Email field.

Retrieves available options for the Email field.

Retrieves available options for the Emails field.

Retrieves available options for the Emails field.

Retrieves available options for the From Email field.

Allows you to get a list of all email address that are globally suppressed. See the docs here