11 available actions

What your AI agent can do in Beehiiv

Beehiiv is a newsletter platform for managing publications, subscribers, posts, automations, audience engagement, and monetization. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.

Common starting points

List PostsSearch a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
List PublicationsList publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
Create Draft PostCreate an unscheduled draft post from HTML content.
Create SegmentCreate an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status.
Update Draft PostUpdate 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…
Update Subscription Custom FieldsSet or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.

Browse all 11 actions by capability

Open a capability to see every supported action and its description.

Find & reviewLook up and review existing recordsView 6 actionsHide actions

List Custom FieldsList the custom-field definitions available for subscriber metadata and dynamic audience segments in a publication, returning one page controlled by page and limit with…
List PostsSearch a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
List PublicationsList publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
List Segment MembersList full subscriber records currently included in an audience segment, optionally including stats, custom fields, referrals, tags, or premium tiers.
List SegmentsList audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.
List SubscriptionsSearch a publication's subscriptions by exact email or filter by status and tier, returning one cursor-controlled page of subscriber records.

Create & communicateCreate records or send supported messagesView 3 actionsHide actions

Create Draft PostCreate an unscheduled draft post from HTML content.
Create SegmentCreate an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status.
Create SubscriptionCreate a new publication subscription without reactivating an unsubscribed address or sending a welcome email; supports attribution, initial custom fields, and…

Update & manageChange and manage existing recordsView 2 actionsHide actions

Update Draft PostUpdate 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…
Update Subscription Custom FieldsSet or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.

Connection record

A connection you can control.

Sign-in: Customer-managed key
Setup: Use a key you create and control. It is stored securely and limited to the work agreed for the role.
Boundaries: Only the approved role and actions.
Off switch: Revoke the connection from your account.

FAQ

Before you connect Beehiiv

How does the agent connect to Beehiiv?

With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.

What can the agent actually do in Beehiiv?

The page above lists the 11 actions currently available through the Beehiiv connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.

Is Beehiiv included in my plan?

Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.

How long until Beehiiv is ready?

Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.

Bring the workflow together

Ready to put Beehiiv to work?

Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.

Book a setup call Browse all connections

All product names, logos, and brands are property of their respective owners and are used for identification only. ZeroToClaw is not affiliated with or endorsed by Beehiiv.