---
name: "Marketing: Beehiiv"
description: Newsletter platform with subscriber management, post publishing, automations, and referral programs. Run it via run_marketing_tool (tool="beehiiv").
version: 1
situations: newsletter, beehiiv
requires-secrets: BEEHIIV_API_KEY
requires-packages:
---

# Marketing: Beehiiv (Newsletter)

Newsletter platform with subscriber management, post publishing, automations, and referral programs.

Call the `run_marketing_tool` tool with `tool: "beehiiv"` and `args: [...]` — args is the same
`{resource} {action} [--flag value ...]` shape as the CLI itself. Output is JSON on stdout.

Example: `run_marketing_tool` with `tool="beehiiv"`, `args=["--help"]`.

Use `--dry-run` on any command to preview the request without sending it. Full command reference (every resource/action/flag): [reference.md](reference.md).

Needs the secret(s) `BEEHIIV_API_KEY` set in the vault (Secrets UI) — ask the operator to add them if
`run_marketing_tool` reports they're missing.