Skip to main content
WEBHOOK
walletDelegationCreated
{
  "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"
}

Authorizations

​
X-Hook0-Signature
string
header
required

HMAC-SHA256 signature of the raw request body, computed using your webhook secret. Webhook receivers should always verify this header before processing the event. The header value is hex-encoded and prefixed by the algorithm and timestamp, e.g. t=1700000000,v1=abc123... (refer to the Webhook Security docs for the exact verification algorithm).

This scheme applies to webhook delivery (outbound POSTs from CDP to your endpoint), not to inbound CDP API requests.

Body

application/json

The wallet.delegation.created webhook event payload.

Delivered when a delegation grant is created for a User Wallet.

​
delegation_id
string
required

The unique identifier for the delegation grant.

Example:

"delegation_af2937b0-9846-4fe7-bfe9-ccc22d935114"

​
user_id
string
required

The user ID that owns the delegation.

Example:

"user_12345"

​
expires_at
string<date-time>
required

When the delegation expires (ISO 8601 format).

Example:

"2025-07-01T10:00:00Z"

​
created_at
string<date-time>
required

When the delegation was created (ISO 8601 format).

Example:

"2025-06-01T10:00:00Z"

Response

Webhook received and processed successfully.