Webhooks

Create a webhook endpoint

Register a URL to receive publish-event webhooks. Returns the plaintext signing secret EXACTLY ONCE — store it immediately. Each delivery has { id, event, delivered_at, data }; id matches X-PostQuickAI-Delivery-Id and is stable across automatic retries. Verify the unmodified raw body with X-PostQuickAI-Signature (t=<unix>,v1=<hex>; HMAC-SHA256 of ${timestamp}.${rawBody} using the secret), and reject stale timestamps. Lost secrets can be replaced via /rotate-secret but not retrieved.

post/v1/webhooks

Request

  • Base URL: https://www.postquick.ai/api
  • URL: https://www.postquick.ai/api/v1/webhooks
  • Auth: HTTP bearer

Request body

app_idstring uuid required

Content group to attach the endpoint to.

urlstring uri required

Publicly reachable HTTPS URL. Loopback / private IPs are rejected.

eventsstring[]

Events to subscribe to. Default is ["*"] (all events). Valid event names: post.{posted,partial,failed}, video.{posted,partial,failed,review_required}, story.{posted,partial,failed}. Subscribe to video.review_required (or *) to reconcile uncertain video outcomes.

Response

Endpoint created. Response includes the plaintext signing secret.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.