Connect Beehiiv to Mailgun

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

Add to an existing mailing list. See the docs here

Create a new route. See the docs here

Delete a mailing list member by address. See the docs here

Retrieve a mailing list member by address. See the docs here

List all mailing list members. See the docs here

Retrieves available options for the Domain Name field.

List domains in Mailgun. See the docs here

Retrieves available options for the Mailing List field.

Send email with Mailgun. See the docs here

Add email to the Mailgun suppression list. See the docs here

Verify email address deliverability with Mailgun. See the docs here