Webhooks
Webhooks allow you to receive real-time notifications when events occur in Kraken Embed. When you register a webhook, Kraken will send HTTP POST requests to your configured URL whenever subscribed events are triggered.
Getting Started
- Register a webhook using the Register Webhook endpoint — you can optionally specify
enabledandeventsat registration time - Store your secret - the webhook secret is only returned once during registration
- Enable and subscribe to events using the Update Webhook endpoint (if not configured at registration)
- Implement signature verification in your webhook handler — see Webhook Events for details
Event Types
| Event Type | Description |
|---|---|
quote.executed | A quote has been successfully executed |
webhook.test | A test event sent via the Test Webhook endpoint |
Retry Behavior
Kraken automatically retries failed webhook deliveries using exponential backoff. The system will continue retrying until the configured timeout is reached:
- Production: Retries for up to 5 minutes
After the retry timeout is exceeded, the webhook delivery is marked as failed and no further attempts are made.
Best Practices
- Respond quickly - Return a 2xx status code within 30 seconds to acknowledge receipt
- Process asynchronously - If your processing takes time, queue the webhook for background processing
- Be idempotent - Webhooks may be delivered more than once
- Monitor failures - Track non-2xx responses and implement alerting
📄️ Get Webhooks
Retrieve all webhooks registered for your domain.
📄️ Register Webhook
Register a new webhook endpoint to receive event notifications from Kraken Embed.
📄️ Update Webhook
Update a webhook's enabled status and/or event subscriptions.
📄️ Delete Webhook
Delete a webhook configuration.
📄️ Test Webhook
Send a test event to verify your webhook configuration.
📄️ Webhook Events
**This endpoint should be implemented by the partner** to receive real-time event notifications from Kraken Embed.