Beehiiv
for LuumenAI

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

Bring Beehiiv into the same conversation as the systems behind it. LuumenAI reads campaigns, audiences, and delivery status for context, and changes them only through previewed, approved, audited actions.

The Beehiiv toolbox

11 tools: 6 read, 5 write. Reads answer instantly. Writes require approval by default. Everything is logged.

  • ReadList 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 pagination metadata for…
  • ReadList PostsSearch a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
  • ReadList PublicationsList publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
  • ReadList Segment MembersList full subscriber records currently included in an audience segment, optionally including stats, custom fields, referrals, tags, or premium tiers.
  • ReadList SegmentsList audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.
  • ReadList SubscriptionsSearch a publication's subscriptions by exact email or filter by status and tier, returning one cursor-controlled page of subscriber records.
  • WriteCreate Draft PostCreate an unscheduled draft post from HTML content. Approval by default
  • WriteCreate SegmentCreate an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status. Approval by default
  • WriteCreate SubscriptionCreate a new publication subscription without reactivating an unsubscribed address or sending a welcome email; supports attribution, initial custom fields, and newsletter-list assignment. Approval by default
  • WriteUpdate 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 schedule. Approval by default
  • WriteUpdate Subscription Custom FieldsSet or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status. Approval by default

Questions

How does LuumenAI connect to Beehiiv?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Beehiiv on its own?

Read actions answer immediately. Anything that writes — create draft post, create segment, create subscription, update draft post, and more — is shown as a plan and requires approval by default. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.

Who gets access to the integration?

You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.

Is there an audit trail?

Every call to Beehiiv — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Beehiiv to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.