Refract Social Webhooks

generated: '2026-11-03'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://refract.social/docs/webhooks
sources:
- https://refract.social/docs/webhooks
description: Refract webhooks deliver JSON POST requests for a fixed set of event types. Each delivery includes a signature header and is retried
  up to seven times on non‑2xx responses.
events:
- event: post.versions_ready
  description: Sent when every version of a post started from a note is written.
- event: post.version_approved
  description: Sent when someone approved a version of a post started from a note.
- event: post.queued
  description: Sent when a post was scheduled or added to the queue.
- event: post.published
  description: Sent when a post went out on an account (one event per account).
- event: post.failed
  description: Sent when a post failed on one or more accounts (one event per failed account).
- event: post.edited
  description: Sent when an edit of a published post was saved to an account's network from Refract (one event per account).
- event: post.removed
  description: Sent when a published post was removed from an account's network from Refract (one event per account).
- event: approval.requested
  description: Sent when someone sent a post, or an edit of a published post, for approval.
- event: account.needs_reconnect
  description: Sent when an account needs signing in again.
- event: account.disconnected
  description: Sent when an account was removed from a workspace.
delivery:
  signature: Refract-Signature header containing timestamp (t) and one or more v1 HMAC‑SHA256 signatures
  content_type: application/json
note: The signing secret is provided as whsec_… when the endpoint is added; the header holds t and v1 values as described on the page. Secrets
  can be rolled, in which case two v1 signatures are sent for 24 hours.
docs: https://refract.social/docs/webhooks