Beehiiv
Beehiiv is a newsletter platform for managing publications, subscribers, posts, automations, audience engagement, and monetization.
Integration
- Vendor
- Beehiiv
- Category
- other
- Auth
- API_KEY
- Tools
- 11
- Composio slug
beehiiv
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
- Create or open a Switchy Project.
- Open Integrations and connect Beehiiv.
- Authorise through api_key. Switchy stores the connection against your org.
- Everyone in the Project can now @-mention the Beehiiv tools in chat.
What teammates see: by default, memories from Beehiiv are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.