Skill

beehiiv

Printing Press CLI for Beehiiv.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use beehiiv

Choose if

You're building a newsletter-operator agent (audience analytics, weekly reporting, subscriber enrichment planning, referral-program audits) on top of Beehiiv. The CLI handles auth, pagination, and rate-limit signaling so the agent can focus on the analysis rather than the API plumbing. Read-mostly, with strict guardrails on the destructive endpoints.

Avoid if

You're not on Beehiiv (Substack, ConvertKit, Ghost, Buttondown, etc. are out of scope), or you need features that are Enterprise-gated without an Enterprise plan. Also avoid letting an agent invoke data-deletion endpoints without explicit human approval — the README warns these are irreversible.

Risk Flags

  • HIGH scope Data deletion endpoints are irreversible — README warns: "This action cannot be undone once processing begins" and "All data associated with the subscription will also be deleted." Agents should never invoke deletion verbs without an explicit human confirmation.
  • MEDIUM scope Engagement-metric window is capped at 31 days; offset-based pagination is deprecated and capped at 100 pages. Long-history backfills require cursor pagination + chunking.
  • MEDIUM scope Several features (Data Deletion API, certain advanced analytics) are Enterprise-only or require support enablement — agents on lower tiers get permission errors.
  • LOW data_quality Post-content sanitization strips `<style>` and `<link>` tags from HTML — agents post-processing newsletter HTML lose styling hooks.

Cost

Type: Usage based · Free tier: Beehiiv's API access is included with the publisher account; the CLI binary itself is MIT-licensed.

Hidden costs

  • The CLI is free, but the underlying Beehiiv API requires an active Beehiiv account. Some endpoints (Data Deletion, certain advanced analytics) are gated to Enterprise plans or require support enablement.

Install

Default

npx -y @mvanhorn/printing-press install beehiiv
export BEEHIIV_API_KEY=<your-key>
export BEEHIIV_PUBLICATION_ID=<pub_xxx>

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js 18+ (or Go 1.26.3+ for source install); active Beehiiv account + API token

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT