Beehiiv

Actions11

• Create draft post

  Create an unscheduled draft post from HTML content.

• 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…

• 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.

• List segments

  List audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.