Webhooks
How Zernio webhook deliveries work and the payload sent for each event.
How to think about webhooks
- Subscribe only to the events you actually handle.
- Treat each delivery as an event notification, not a full source of truth sync.
- Use the webhook event ID as your deduplication key.
- Verify the
X-Zernio-Signatureheader when you configure a webhook secret. - Expect fast acknowledgement from your endpoint and move heavier processing to async jobs.
Delivery flow
- Create a webhook endpoint with Create webhook settings.
- Choose the events you want to subscribe to.
- Receive a
POSTrequest from Zernio whenever one of those events occurs. - Return a
2xxresponse after you have accepted the payload. - Use Test webhook and Webhook logs to validate your integration.
Available events
| Event | Description |
|---|---|
post.published | Fired when a post is successfully published. |
post.failed | Fired when a post fails to publish on all target platforms. |
post.partial | Fired when a post publishes on some platforms and fails on others. |
post.cancelled | Fired when a post publishing job is cancelled. |
post.scheduled | Fired when a post is scheduled for future publishing. |
post.recycled | Fired when a post is recycled for republishing. |
account.connected | Fired when a social account is successfully connected. |
account.disconnected | Fired when a connected social account becomes disconnected. |
message.received | Fired when a new inbox message is received. |
message.sent | Fired when an outgoing message is sent from the inbox. |
comment.received | Fired when a new comment is received on a tracked post. |
webhook.test | Fired when sending a test webhook to verify the endpoint configuration. |
post.published
Fired when a post is successfully published. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
post.failed
Fired when a post fails to publish on all target platforms. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
post.partial
Fired when a post publishes on some platforms and fails on others. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
post.cancelled
Fired when a post publishing job is cancelled. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
post.scheduled
Fired when a post is scheduled for future publishing. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
post.recycled
Fired when a post is recycled for republishing. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"post.scheduled" | "post.published" | "post.failed" | "post.partial" | "post.cancelled" | "post.recycled"date-timeResponse Body
account.connected
Fired when a social account is successfully connected. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"account.connected"date-timeResponse Body
account.disconnected
Fired when a connected social account becomes disconnected. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"account.disconnected"date-timeResponse Body
message.received
Fired when a new inbox message is received. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"message.received"Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
date-timeResponse Body
message.sent
Fired when an outgoing message is sent from the inbox. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"message.sent"date-timeResponse Body
comment.received
Fired when a new comment is received on a tracked post. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"comment.received"date-timeResponse Body
webhook.test
Fired when sending a test webhook to verify the endpoint configuration. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"webhook.test"Human-readable test message
date-time