Registering webhooks (coming soon)

TIP

We are currently opening up access to server wallet webhooks. Reach out if you don't see the webhook you are interested in, listed below.

To keep your backend in sync with the state of the blockchain, Privy emits webhooks whenever funds are sent or received from a wallet.

Configuration

Configure webhooks in the Webhooks page of the Dashboard by providing a destination endpoint for the webhook updates.

Funds received

When funds are received by a wallet, Privy will emit a webhook with a payload of the following shape to the endpoint you configure:

Field	Type	Description
wallet_id	string	Unique ID of the updated wallet.
asset	string	Type of asset such as ETH or SOL.
amount_received	number	Amount received in asset type.
balance	number	Total balance of the wallet in native currency.
address	string	Ethereum or solana address of receiver.
transaction_hash	string	Hash of ethereum or solana transaction.
sender_address	string	Wallet address of the sender.
chain_id	string	CAIP-2 chain ID of transaction.

Example

Below is an example payload that will hit your webhooks endpoint when funds are received in a wallet.

{
  "wallet_id": "cm4db8x9t000ccn87pctvcg9j",
  "asset": "ETH",
  "amount_received": 1000000000000000000,
  "balance": 5000000000000000000,
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c",
  "chain_id": "eip155:1"
}

Funds sent

When funds are sent from a wallet, Privy will emit a webhook with a payload of the following shape to the endpoint you configure:

Field	Type	Description
wallet_id	string	Unique ID of the updated wallet.
asset	string	Type of asset such as ETH or SOL.
amount_sent	number	Amount sent in native currency.
balance	number	Total balance in native currency after sending.
address	string	Ethereum or solana address of sender.
transaction_hash	string	Hash of ethereum or solana transaction.
recipient_address	string	Wallet address of the recipient.
chain_id	string	CAIP-2 chain ID of transaction.

Example

Below is an example payload that will hit your webhooks endpoint when funds are sent from a wallet.

{
  "wallet_id": "cm4db8x9t000ccn87pctvcg9j",
  "asset": "ETH",
  "amount_sent": 2000000000000000000,
  "balance": 3000000000000000000,
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "transaction_hash": "0x3557f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9c67d",
  "chain_id": "eip155:1"
}