PostzivoDOCS
Browse documentation
WEBHOOKS

React when social work changes.

Subscribe your backend to publishing, approval, inbox, and workflow events instead of polling the API.

Create a subscription

cURLCopy and customize
curl -sS "https://app.postzivo.com/api/public/v1/webhooks" \
  -X POST \
  -H "Authorization: Bearer $POSTZIVO_API_KEY" \
  -H "Idempotency-Key: webhook-001" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/postzivo",
    "events": ["post.published", "post.failed", "approval.updated"]
  }'

Delivery rules

  • Return a successful 2xx response quickly and process work asynchronously.
  • Deduplicate events by delivery or event identifier.
  • Expect retries after timeouts and non-success responses.
  • Do not assume events arrive in the same order that changes occurred.
  • Log the request identifier and event type for investigation.
i

Verify every delivery.
Use the signing secret provided when the subscription is created. Reject requests with an invalid signature or stale timestamp.

Example event

JSONCopy and customize
{
  "id": "evt_123",
  "type": "post.published",
  "created_at": "2026-07-22T10:30:00Z",
  "workspace_id": "ws_123",
  "data": {
    "post_id": "post_123",
    "platform": "linkedin",
    "status": "published"
  }
}
READY TO BUILD?

Connect your workflow.

Request access, create an API key, and start with one test workspace.

Get started