beehiiv

beehiiv Webhooks API

The Webhooks API from beehiiv — 0 operation(s) for webhooks.

GitHub OpenAPI
Business capability
Webhook & Event Subscription Management BC-4270.80

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /publications/{publicationId}/webhooks Create a webhook · Create a webhook OAuth Scope: webhooks:write #
Ask an LLM
“How do I get notified at my own URL when someone subscribes?”
“Which event types can I pick when registering a webhook?”
Tell an agent
Create a webhook on publication {publication} sending {event_types} events to {url}.
Register {url} as a webhook for {event_types} with description {description}.
GET /publications/{publicationId}/webhooks List a publication's webhooks · List webhooks OAuth Scope: webhooks:read #
Ask an LLM
“Which webhooks are registered on my newsletter?”
“Where are my publication's events currently being delivered?”
Tell an agent
List webhooks on publication {publication}.
Show where {publication} currently delivers webhook events.
GET /publications/{publicationId}/webhooks/{endpointId} Get one webhook · Get webhook OAuth Scope: webhooks:read #
Ask an LLM
“What events and URL is a specific webhook configured with?”
“Can I look up a single webhook by its endpoint ID?”
Tell an agent
Get webhook {webhook} on publication {publication}.
Show the URL and events configured on webhook {webhook}.
PATCH /publications/{publicationId}/webhooks/{endpointId} Change a webhook's events or description · Update webhook OAuth Scope: webhooks:write #
Ask an LLM
“How do I change which events an existing webhook listens for?”
“Can I edit a webhook's description after creating it?”
Tell an agent
Update webhook {webhook} on {publication} to listen for {event_types}.
Change the description of webhook {webhook} to {description}.
DELETE /publications/{publicationId}/webhooks/{endpointId} Delete a webhook · Delete a webhook OAuth Scope: webhooks:write #
Ask an LLM
“How do I stop a webhook from receiving events?”
“Can I remove a webhook subscription from my publication?”
Tell an agent destructive · confirm first
Delete webhook {webhook} from publication {publication}.
Stop webhook {webhook} from receiving any more events.

Documentation

📖
Documentation
https://developers.beehiiv.com/oauth2
📖
Authentication
https://artifacts.apis.io/beehiiv/authentication/beehiiv-authentication.yml
📖
Documentation
https://developers.beehiiv.com/webhooks

Specifications

⚙
OpenAPI
https://artifacts.apis.io/beehiiv/openapi/beehiiv-webhooks-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/beehiiv/asyncapi/beehiiv-asyncapi.yml

Other Resources

🔗
OAuthScopes
https://artifacts.apis.io/beehiiv/scopes/beehiiv-scopes.yml
🔗
Webhooks
https://artifacts.apis.io/beehiiv/openapi/_original/beehiiv-webhook-events-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/beehiiv:beehiiv-webhooks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

beehiiv-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Beehiiv Webhooks API
  version: 1.0.0
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: beehiiv-openapi.yml, beehiiv-webhook-events-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.beehiiv.com/v2
  description: Default
tags:


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://artifacts.apis.io/beehiiv/openapi/beehiiv-webhooks-api-openapi.yml