# Beehiiv MCP

Vendor: Beehiiv  
Category: other  
Auth: API_KEY  
Composio slug: `beehiiv`

Beehiiv is a newsletter platform for managing publications, subscribers, posts, automations, audience engagement, and monetization.

## Tools

- **Create Draft Post** — Create an unscheduled draft post from HTML content. This tool never confirms, publishes, schedules, or sends the post. Beehiiv creates posts asynchronously; the returned ID is stable while background creation finishes.
- **Create Segment** — Create an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status.
- **Create Subscription** — Create a new publication subscription without reactivating an unsubscribed address or sending a welcome email; supports attribution, initial custom fields, and newsletter-list assignment.
- **List Custom Fields** — List the custom-field definitions available for subscriber metadata and dynamic audience segments in a publication, returning one page controlled by page and limit with pagination metadata for retrieving additional fields.
- **List Posts** — Search a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
- **List Publications** — List publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
- **List Segment Members** — List full subscriber records currently included in an audience segment, optionally including stats, custom fields, referrals, tags, or premium tiers. The response contains subscriber PII.
- **List Segments** — List audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.
- **List Subscriptions** — Search a publication's subscriptions by exact email or filter by status and tier, returning one cursor-controlled page of subscriber records.
- **Update Draft Post** — Update content or presentation settings on an existing draft after verifying it is still a draft; refuses confirmed, archived, or sent posts and cannot publish or schedule.
- **Update Subscription Custom Fields** — Set or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect Beehiiv.
3. Authorise through api_key.
4. Teammates can now @-mention Beehiiv tools in chat.

---
Last verified: 2026-09-04T02:00:56.012Z  
Canonical URL: https://switchy.build/directory/mcps/beehiiv