Webhook Events

Post events

  • post.scheduled: A post became scheduled or its scheduled time changed, including moves by a queue reshuffle; content-only edits, drafts, and posts published immediately do not emit it.
  • post.published: Every target of a post published successfully.
  • post.partially_failed: A post finished publishing with at least one target published and the rest failed or canceled.
  • post.failed: A post finished publishing and none of its targets published.
  • post.cancelled: A scheduled or queued post was deleted (reason: deleted) or moved back to a draft (reason: unscheduled) before it published.

Delivered as a POST to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by id.

postWebhookpostEvents

Payload

idstring required

Event id (evt_…). Stable across automatic retries and manual redeliveries; deduplicate on it.

type'post.scheduled' | 'post.published' | 'post.partially_failed' | 'post.failed' | 'post.cancelled' required
apiVersionstring required

Payload version.

createdAtstring date-time required

When the event was created.

Example payload

{
  "apiVersion": "2026-08-06"
}

Response

Acknowledges the delivery. Any other status, or no response within 10 seconds, schedules a retry.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.