OmniVocal by Microcorp
beehiiv

Email & Newsletters

OmniVocal + Beehiiv

OmniVocal publishes a post to Beehiiv and sends it to all free subscribers immediately. Markdown is converted to HTML, and content_tags are passed through for categorisation.

What you'll need

  • API key — app.beehiiv.com → Settings → API → Generate API Key.
  • Publication ID — From the URL: app.beehiiv.com/v2/publications/{PUBLICATION_ID}/...

Setup guide

  1. 1

    Log in to app.beehiiv.com → Settings → API → Generate API Key.

  2. 2

    Copy your publication ID from the dashboard URL.

  3. 3

    In OmniVocal Dashboard → Channels → Beehiiv, enter the API key and publication ID.

  4. 4

    Broadcast with target channel "beehiiv". The post is published and sent immediately.

Example broadcast call

Ask your AI assistant (Copilot, Claude, Cursor) to call broadcast_post — or call the REST API directly:

{
  "content": {
    "title": "Dev Log #3 — Ghost and Mastodon",
    "body": "## What shipped this week\n\nWe added two new channels...",
    "tags": ["devlog", "product"],
    "canonical_url": "https://omnivocal.io/devlog/3"
  },
  "targets": [{ "channel": "beehiiv" }]
}

Tips & notes

  • Tags map to Beehiiv content_tags (plain string labels, no lookup needed).
  • status: "confirmed" is used — posts are sent immediately to free subscribers.
  • Pass body_format: "html" if your body is already HTML.