Agent webhooks

Events emitted for delegated access: delegation grants, signatures, and revocations.

Agent-facing wallet events fire under the wallet.delegation.* namespace. They cover the lifecycle of delegated access: a user granting an agent or service permission to act with their wallet, signatures produced under that grant, and the grant being revoked.

For the shared event envelope, endpoint setup, retries, and signature verification, see Setting up webhooks and Event delivery & best practices. The current list of event types is always available from the event types endpoint.

Delegation events

wallet.delegation.created · object

Occurs whenever a delegated share set is created for a wallet, granting a delegated entity signing access.

wallet.delegation.signature · object

Occurs whenever a WaaS wallet signature is completed from a delegated entity. Is a wallet.

wallet.delegation.revoked · object

Occurs whenever a delegated share set is revoked, ending the delegated entity’s access.

Related events

• Wallet lifecycle and signing events (wallet.created, wallet.signature, and others) are documented under Embedded wallet webhooks.