API & Webhooks

Webhook events

Subscribe to real-time events from Winora and receive HTTP callbacks.

Webhook events

Webhooks let you subscribe to events in Winora and receive real-time HTTP POST notifications to your own server.

Creating a webhook

Go to Settings → Webhooks.
Click New webhook.
Enter the endpoint URL.
Select the events to subscribe to.
Save.

Available events

Event	Fires when…
`conversation.created`	A new conversation is opened
`conversation.resolved`	A conversation is marked Resolved
`conversation.assigned`	A conversation is assigned to an agent
`message.received`	A customer sends a message
`message.sent`	An agent sends a message
`contact.created`	A new contact is created
`csat.response`	A CSAT survey is submitted

Payload structure

Every webhook POST has the same envelope:

{
  "event": "conversation.created",
  "workspaceId": "clxxx",
  "timestamp": "2026-05-20T10:30:00Z",
  "data": { ... }
}

The data object contains the full resource that changed.

Signature verification

Each request includes an X-Winora-Signature header - a HMAC-SHA256 of the raw request body signed with your webhook secret. Always verify this before processing the payload.

Retries

Failed deliveries (non-2xx) are retried up to 5 times over 24 hours.