---
title: "Webhooks: 1Post docs"
url: "https://get1post.com/docs/webhooks.md"
canonical_url: "https://get1post.com/docs/webhooks"
last_updated: "2026-10-26"
type: "reference"
summary: "Add an endpoint, choose which events and accounts it covers, verify the Standard Webhooks signature and send a test event."
related: ["https://get1post.com/docs/reconnect-and-failures.md", "https://get1post.com/docs/api.md", "https://get1post.com/docs/api-authentication.md", "https://get1post.com/docs.md"]
---

# Webhooks: 1Post docs

Add an endpoint, choose which events and accounts it covers, verify the Standard Webhooks signature and send a test event.

Add an https endpoint with POST /v1/webhooks and pick the events you want, such as post.published, post.failed, post.unknown, post.missed, post.approved, account.reconnect_needed and allowance.low. Each delivery is signed with the Standard Webhooks scheme, using a whsec_ secret that is shown once, so your code can check that it really came from 1Post.

## Set up

1. Add the endpoint. The address must be public and use https. Scope it to some accounts if you like.
2. Store the whsec_ secret from the reply; it is shown only once.
3. Verify the signature headers on every delivery before you trust the body.
4. Send a test event with POST /v1/webhooks/{id}/test.

## Events

- post.published, post.failed, post.unknown, post.missed: what happened to a destination.
- post.approved: a post was approved.
- account.reconnect_needed: an account needs signing in again.
- allowance.low: a monthly allowance is nearly used.

A plan allows a set number of endpoints: Starter 5, Creator 25, Agency 100.

## Questions

**Can I send a post to my own URL as a destination?**

Yes. A webhook address can be connected as an account, so a post is delivered to it as a signed request.

## Related

- [Failures, retries and unknown outcomes: 1Post docs](https://get1post.com/docs/reconnect-and-failures.md)
- [1Post API reference: every route, key and role](https://get1post.com/docs/api.md)
- [API authentication and keys: 1Post docs](https://get1post.com/docs/api-authentication.md)
- [1Post docs: composer, scheduling, API, webhooks, MCP](https://get1post.com/docs.md)