/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 a200 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
- Click Add Webhook
- Enter the destination URL (must be publicly accessible HTTPS)
- Choose which events to subscribe to
- Optionally add a secret for signature verification
- 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 theX-Winnerr-Signature header. Verify it in your endpoint: