> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.beehiiv.com/webhooks/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.beehiiv.com/_mcp/server. > **Warning** > > Webhooks are currently only available for paid users on the Lite plan and > above. To upgrade your account, click > [here](https://app.beehiiv.com/settings/billing). ## Why use webhooks Webhooks are a way to receive real-time notifications when certain events occur on your beehiiv publication. These can be helpful for: * Integrating your publication with other services. * Keeping track of your audience in third-party apps. * And more. ## How to configure webhooks Webhooks can be configured in two ways: 1. In the app: Navigate to `Settings > Webhooks`. 2. Using the API: Send a `POST` request to the `/webhooks` endpoint (see [API reference](/api-reference/webhooks/post-webhooks)). The event types are listed in the sidebar of this page and are organized by the resource they are associated with. ## Verifying webhook signatures beehiiv delivers webhooks through [Svix](https://www.svix.com/). Each request includes `svix-id`, `svix-timestamp`, and `svix-signature` headers that you should verify with your endpoint's signing secret before processing the payload. You can find the signing secret in the app under `Settings > Webhooks` on the endpoint details page. For step-by-step verification instructions, see the [Svix documentation on verifying payloads](https://docs.svix.com/receiving/verifying-payloads/how-manual). ## Webhooks in Zapier and Make The beehiiv team currently maintain a [Zapier integration](https://zapier.com/apps/beehiiv/integrations) and a [Make integration](https://www.make.com/en/integrations/beehiiv). In Zapier, webhooks are known as "Triggers," which assist the user set up a webhook without having to set them up in the app as outlined above. In Make, users should use the [Custom Webhook](https://www.make.com/en/help/tools/webhooks) module and follow step 1 above to set up their webhook to point to the Make-provided URL. > Build your audience with beehiiv's API and SDKs. Create new subscribers and posts, get real-time notifications of subscription activity, and more. ## API Docs - Webhooks > Newsletter List Subscription [Newsletter List Subscription Subscribed](https://developers.beehiiv.com/webhooks/newsletter-list-subscription/subscribed.md) - Webhooks > Newsletter List Subscription [Newsletter List Subscription Unsubscribed](https://developers.beehiiv.com/webhooks/newsletter-list-subscription/unsubscribed.md) - Webhooks > Newsletter List Subscription [Newsletter List Subscription Paused](https://developers.beehiiv.com/webhooks/newsletter-list-subscription/paused.md) - Webhooks > Newsletter List Subscription [Newsletter List Subscription Resumed](https://developers.beehiiv.com/webhooks/newsletter-list-subscription/resumed.md) - Webhooks > Podcasts [Podcast Episode Published](https://developers.beehiiv.com/webhooks/podcasts/episode-published.md) - Webhooks > Podcasts [Podcast Episode Updated](https://developers.beehiiv.com/webhooks/podcasts/episode-updated.md) - Webhooks > Podcasts [Podcast Episode Archived](https://developers.beehiiv.com/webhooks/podcasts/episode-archived.md) - Webhooks > Podcasts [Podcast Episode Deleted](https://developers.beehiiv.com/webhooks/podcasts/episode-deleted.md) - Webhooks > Podcasts [Podcast Private Feed Activated](https://developers.beehiiv.com/webhooks/podcasts/private-feed-activated.md) - Webhooks > Podcasts [Podcast Private Feed Access Revoked](https://developers.beehiiv.com/webhooks/podcasts/private-feed-access-revoked.md) - Webhooks > Podcasts [Podcast Private Feed Deactivated](https://developers.beehiiv.com/webhooks/podcasts/private-feed-deactivated.md) - Webhooks > Post [Post Sent](https://developers.beehiiv.com/webhooks/post/sent.md) - Webhooks > Post [Post Updated](https://developers.beehiiv.com/webhooks/post/updated.md) - Webhooks > Post [Post Scheduled](https://developers.beehiiv.com/webhooks/post/scheduled.md) - Webhooks > Subscription [Subscription Created](https://developers.beehiiv.com/webhooks/subscription/created.md) - Webhooks > Subscription [Subscription Confirmed](https://developers.beehiiv.com/webhooks/subscription/confirmed.md) - Webhooks > Subscription [Subscription Deleted](https://developers.beehiiv.com/webhooks/subscription/deleted.md) - Webhooks > Subscription [Subscription Upgraded](https://developers.beehiiv.com/webhooks/subscription/upgraded.md) - Webhooks > Subscription [Subscription Downgraded](https://developers.beehiiv.com/webhooks/subscription/downgraded.md) - Webhooks > Subscription [Subscription Paused](https://developers.beehiiv.com/webhooks/subscription/paused.md) - Webhooks > Subscription [Subscription Resumed](https://developers.beehiiv.com/webhooks/subscription/resumed.md) - Webhooks > Subscription [Subscription Tier Paused](https://developers.beehiiv.com/webhooks/subscription/tier-paused.md) - Webhooks > Subscription [Subscription Tier Resumed](https://developers.beehiiv.com/webhooks/subscription/tier-resumed.md) - Webhooks > Subscription [Subscription Tier Created](https://developers.beehiiv.com/webhooks/subscription/tier-added.md) - Webhooks > Subscription [Subscription Tier Deleted](https://developers.beehiiv.com/webhooks/subscription/tier-deleted.md) - Webhooks > Survey [Survey Response Submitted](https://developers.beehiiv.com/webhooks/survey/submitted.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developers.beehiiv.com/openapi.json) - [OpenAPI YAML](https://developers.beehiiv.com/openapi.yaml)