Beehiiv API

Send newsletters to your Beehiiv subscribers via RelayAPI — cross-post social content to email in a single API call.

Quick Reference

Property	Value
Platform key	`beehiiv`
Auth method	API Key
Content format	HTML (plain text auto-wrapped)
Scheduling	Yes
Analytics	No

Before You Start

You need a Beehiiv API key and your publication ID. Get these from your Beehiiv dashboard under Settings > Integrations > API.

Connect

curl -X POST https://api.relayapi.dev/v1/connect/beehiiv \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your-beehiiv-api-key",
    "publication_id": "pub_xxxxxxxx"
  }'

Cross-post to Beehiiv alongside social platforms:

curl -X POST https://api.relayapi.dev/v1/posts \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our weekly product update...",
    "targets": ["twitter", "acc_beehiiv123"],
    "scheduled_at": "now",
    "target_options": {
      "beehiiv": {
        "subject": "Weekly Update #42",
        "preview_text": "New features, bug fixes, and more",
        "content_html": "<h1>Weekly Update</h1><p>Here is what we shipped...</p>"
      }
    }
  }'

`target_options` Fields

All fields go inside target_options.beehiiv on your post request.

Field	Type	Required	Description
`subject`	string	No	Email subject line. Falls back to first line of content.
`preview_text`	string	No	Preview text shown in email clients.
`content_html`	string	No	Full HTML body. If omitted, plain text content is auto-wrapped in HTML.

Discovery

List your publication info:

GET /v1/accounts/{id}/lists

Returns the publication as a single list entry.

Automations

Beehiiv is a Tier 3 newsletter platform — triggers fire on subscription lifecycle events, and destination nodes upsert subscribers / publish posts.

Triggers

Type	Fires on
`beehiiv_subscription_created`	New subscription (any status)
`beehiiv_subscription_confirmed`	Double-opt-in confirmed
`beehiiv_subscription_deleted`	Subscriber removed

Send nodes

Base: https://api.beehiiv.com/v2. API key auth (Bearer).

Node	Endpoint	Required fields
`beehiiv_add_subscriber`	`POST /publications/{id}/subscriptions`	`email`, optional `utm_*` / `reactivate_existing`
`beehiiv_publish_post`	`PATCH /publications/{id}/posts/{post_id}` (status=confirmed)	`post_id` (pre-created draft)
`beehiiv_enroll_automation`	`POST /publications/{id}/automations/{auto_id}/journeys`	`email`, `automation_id`

Found something wrong? Help us improve this page.

Report an issue Edit this page on GitHub

Beehiiv API

On this page