Skip to main content
Register a webhook via Create a Withdrawal Webhook to receive withdrawal lifecycle events instead of polling. JSON payload shapes are in the Withdrawal payload reference. Deliveries include Authorization: Bearer <sharedToken> and an X-Signature HMAC-SHA256 header keyed with the same token. See Webhook request headers for the full header reference. Verify signatures using Verifying Webhook Signatures.

​
Supported Events

  • SUBMITTING — the first-leg broadcast has started.
  • SUBMITTED — the withdrawal transaction has been broadcast on the source chain.
  • BRIDGING — a cross-chain withdrawal has cleared the source chain and the bridge leg is in flight.
  • COMPLETED — the withdrawal has settled successfully. (Previously named CONFIRMED.)
  • FAILED — the withdrawal failed. Inspect errorReason via the Get Withdrawal Detail endpoint.
  • FAILED_EXPIRED — the quote expired before broadcast (e.g. stale blockhash or user operation); re-quote from prepare.
  • REFUNDED_BY_PROVIDER — the bridge bounced funds back.
The CONFIRMED event has been renamed to COMPLETED. Update any webhook consumers that match on CONFIRMED.