Skip to main content

Why Use Webhooks?

Configure Webhooks

Configure in Hub: WebhooksAdd Webhook Endpoint URL: e.g., https://api.yourgame.com/webhooks/immutable Events: Mints, transfers, orders, trades

Webhook Payload

Verify Webhook Signatures

Retry Policy

Exponential backoff on errors: After 5 failed attempts, view and retry in Hub.

Best Practices

Return a 200 response immediately, then process the event asynchronously. Webhook requests timeout after 30 seconds.
Use the event_id to deduplicate events. The same event may be delivered more than once.
Always verify the webhook signature. Use HTTPS for your endpoint.

Next Steps

Indexer API

Query blockchain data directly

Minting Events

Handle minting webhooks