Webhooks

Create a webhook

Create a new webhook endpoint. Maximum 10 webhooks per user. The webhook secret is only returned on creation - save it securely.

post/webhooks

Request body

namestring required

Friendly name for the webhook

urlstring uri required

HTTPS URL to receive webhook events

eventsstring[] required

Events to subscribe to. token.expiring is defined but not currently dispatched; post.demoted fires when an attach/detach returns a scheduled group to draft.

Example request

{
  "name": "Production webhook",
  "url": "https://example.com/webhooks/publora",
  "events": [
    "post.published",
    "post.failed"
  ]
}

Response

Webhook created

successboolean

Example response

{
  "success": true
}

Changes