Skip to main content
POST
Register a webhook
The full lifecycle, payload formats, signature verification, and Discord/Slack auto-detection are documented at Webhooks.
The secret is only returned at creation time. Save it immediately — you’ll need it to verify HMAC signatures on incoming webhook deliveries.

Authorizations

Api-Key
string
header
required

Demo API-Key (Sandbox): 7037d2b3-9c76-4f62-b730-c544f7570fa4

Body

application/json
url
string<uri>
required

HTTPS URL. Discord/Slack URLs are auto-detected.

events
enum<string>[]

Defaults to all 6 events.

Available options:
quote.created,
deposit.initiated,
swap.pending,
swap.success,
swap.failed,
swap.refunded
type
enum<string>

Auto-detected from URL if omitted.

Available options:
standard,
discord,
slack

Response

Webhook created. The secret is only returned once.

data
object
required