Skip to main content
Privy emits webhooks when wallet actions change status, allowing your app to react to swaps, transfers, payouts, and earn activity in real time without polling.

Setup

Subscribe to wallet action events from the Configuration > Webhooks page in the Privy Dashboard. For general webhook setup instructions, payload verification, and retry behavior, see the webhooks overview.
Webhooks can be tested at no cost in development environments. To enable webhooks in production, upgrade to the Enterprise plan in the Privy Dashboard.

Statuses

Every wallet action moves through a predictable status lifecycle. Privy emits a webhook at each status update.

Action-specific payloads

All wallet action webhook payloads include the following fields. Beyond these, each payload includes fields specific to that action, such as its assets and amounts. View the payloads for specific wallet actions below. Click the webhook event name to be redirected to its payload schema.

Transfer

Swap

Payout

Payouts move crypto out of the wallet on-chain and then settle fiat at the provider, so succeeded means the fiat settled, not just that the crypto moved. failed spans several outcomes that call for different handling, depending on whether the crypto had already left the wallet. See payout failure modes for how to tell them apart, and for the payload fields.

Earn

Deposit

Withdraw

Claim incentive

Collect fees