Connect Beehiiv to Your AI Agent

Provide a publication and post IDs, then choose content or performance analysis. AI can compare editions and explain the evidence behind differences.

6 tools API key

Try a Beehiiv Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Beehiiv

Compare Newsletter Editions

Read selected post content and ask AI to compare themes and audience relevance.

/oo Beehiiv: Read Beehiiv posts [post IDs] in publication [publication ID], including their web content. Compare themes and messages for this audience: [audience].

Review Post Performance

Read expanded post statistics and explain differences without assuming causation.

/oo Beehiiv: Read statistics for Beehiiv posts [post IDs] in publication [publication ID]. Compare the metrics returned and suggest questions for further investigation.

Start Working with Beehiiv

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Beehiiv

    Connect with a Beehiiv API key.

    Connect Beehiiv →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Beehiiv API key with access to the publication.

Beehiiv Tools

Beehiiv post records can include content and statistics, while subscription records describe the audience’s subscription state. These are sources for editorial and audience reviews.

Read Posts and Statistics

List posts and retrieve content or statistics using expansions.

Read Publications and Subscriptions

Retrieve publication information and filter subscription records.

6 tools

List Publications

List Beehiiv publications associated with the API key, with optional sorting and expansion.

beehiiv.list_publications

Get Publication

Fetch one Beehiiv publication by ID with optional statistics expansion.

beehiiv.get_publication

List Posts

List Beehiiv posts for a publication with documented filters and optional expansions.

beehiiv.list_posts

Get Post

Fetch one Beehiiv post by ID with optional statistics or content expansion.

beehiiv.get_post

List Subscriptions

List Beehiiv subscriptions for a publication with cursor pagination and documented filters.

beehiiv.list_subscriptions

Get Subscription

Fetch one Beehiiv subscription by ID with optional expansions.

beehiiv.get_subscription

Frequently Asked Questions

Can AI read the article content rather than just the title?

Yes. Request the relevant web or email content expansion when retrieving a post.

Can AI compare statistics across posts?

Yes. Supply the publication and post IDs and request statistics; comparisons should use the metrics actually returned.

Will this publish or send a newsletter?

No. These supported operations read publications, posts, and subscription records.

Connect Beehiiv

About Beehiiv ↗