Skip to main content
Webhooks (/settings/webhooks) lets you push Winnerr events to any external URL in real time — so your other tools can react to what happens in your CRM automatically.

How webhooks work

When a specified event occurs in Winnerr (e.g., a new contact is created), Winnerr sends an HTTP POST request to your endpoint URL with a JSON payload describing the event. Your endpoint must respond with a 200 OK within 10 seconds. If it times out or returns an error, Winnerr will retry up to 3 times with exponential backoff.

Creating a webhook

  1. Click Add Webhook
  2. Enter the destination URL (must be publicly accessible HTTPS)
  3. Choose which events to subscribe to
  4. Optionally add a secret for signature verification
  5. Click Save — the webhook is live immediately

Available events

Payload format

Every webhook payload follows this structure:

Verifying signatures

If you set a webhook secret, Winnerr signs every request with an HMAC-SHA256 signature in the X-Winnerr-Signature header. Verify it in your endpoint:

Logs & debugging

The Logs tab shows the last 500 webhook delivery attempts — request body, response status, response body, and delivery time. Use this when debugging a new integration. Manually replay any failed delivery from the logs view.