Webhooks

Add a subscription under Webhooks: URL, events and authentication. Before activation we send webhook.verification and your endpoint must answer 2xx.

Events

`social.connection.updated`	Connection or permissions changed
`social.connection.expiring`	Connection is about to expire
`social.post.published`	Published on an account
`social.post.partially_published`	Published on some accounts, failed on others
`social.post.failed`	Publishing failed
`social.comment.created`	New comment
`social.comment.updated`	Comment edited or hidden
`social.comment.deleted`	Comment deleted
`social.comment.replied`	Replied through the platform

Envelope

POST /your/endpoint
Content-Type: application/json
X-Webhook-Id: evt_0192f0c4...
X-Webhook-Timestamp: 1790426650
X-Webhook-Signature: sha256=5d41402abc4b2a76b9719d911017c592...
X-Webhook-Version: 1.0
X-Webhook-Event: social.comment.created
X-Correlation-Id: CRM-REQUEST-773

{
  "id": "evt_0192f0c4...",
  "type": "social.comment.created",
  "version": "1.0",
  "occurredAt": "2026-09-26T10:15:02Z",
  "tenantId": "0192...",
  "correlationId": "CRM-REQUEST-773",
  "externalReference": null,
  "data": { "comment": { ... }, "socialAccount": { ... }, "postId": "0192..." }
}

Delivery

Any 2xx is success. 5xx, 408, 429 or a network failure is retried with growing delays.
Other 4xx answers are final and not retried automatically; resend them by hand from the log.
The same event may arrive more than once: use X-Webhook-Id to drop duplicates.
After a configurable number of consecutive failures the subscription pauses; events wait until you resume it.