Beehiiv

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

11 actions Integration catalog
Request access
Connect Beehiiv once you're in Boring.
01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Create Draft PostBEEHIIV_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 SegmentBEEHIIV_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 SubscriptionBEEHIIV_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 FieldsBEEHIIV_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 PostsBEEHIIV_LIST_POSTS
Search a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
List PublicationsBEEHIIV_LIST_PUBLICATIONS
List publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
List Segment MembersBEEHIIV_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 SegmentsBEEHIIV_LIST_SEGMENTS
List audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.
List SubscriptionsBEEHIIV_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 PostBEEHIIV_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 FieldsBEEHIIV_UPDATE_SUBSCRIPTION_CUSTOM_FIELDS
Set or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.