Skip to main content

WebhookEnvelope

Body of every webhook delivery. Verify X-Signature (HMAC-SHA256 of the raw body with the webhook secret) before trusting it, and de-duplicate on id. See Webhooks.

eventstringrequired

Possible values: [post.created, post.updated, post.scheduled, post.published, post.publishing_failed, post.published_all, post.deleted, account.added, account.updated, account.deleted, account.token_expiring, account.disconnected, inbox.draft.created, inbox.draft.sent]

idstring<uuid>required

Delivery ID, one per event. Retries and manual resends repeat it.

occurred_atstring<date-time>required

When the event happened (ISO 8601, UTC).

Example: 2026-10-12T10:00:03+00:00
workspace_uuid(string | null)<uuid>nullablerequired

The workspace the event belongs to (null only on instance-wide system webhooks). Also sent as the X-PostBoost-Workspace header.

data objectrequired

The post (post.*, as getPost returns it, plus account on per-account events), the account (account.*) or the reply draft (inbox.*).

property name*any

The post (post.*, as getPost returns it, plus account on per-account events), the account (account.*) or the reply draft (inbox.*).

WebhookEnvelope
{
"event": "post.created",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"occurred_at": "2026-10-12T10:00:03+00:00",
"workspace_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"data": {}
}