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
2xxresponse 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.