Wallet Webhooks

Wallet delegation created

Triggered when the wallet.delegation.created webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookwalletDelegationCreated

Payload

delegation_idstring required

The unique identifier for the delegation grant.

user_idstring required

The user ID that owns the delegation.

expires_atstring date-time required

When the delegation expires (ISO 8601 format).

created_atstring date-time required

When the delegation was created (ISO 8601 format).

Example payload

{
  "delegation_id": "delegation_af2937b0-9846-4fe7-bfe9-ccc22d935114",
  "user_id": "user_12345",
  "expires_at": "2025-07-01T10:00:00Z",
  "created_at": "2025-06-01T10:00:00Z"
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.