Usage recorded — gas sponsorship

Fired when Privy records a sponsored-gas charge for a wallet action.

postWebhookusage.gas_sponsorship.recorded

Payload

type'usage.gas_sponsorship.recorded' required

The type of webhook event.

event_idstring required

An opaque, stable identifier for this charge. Use it to deduplicate webhook deliveries.

source_idstring required
source_type'wallet-action-transfer' | 'wallet-action-swap' | 'rpc' required

The type of operation that incurred a usage charge.

amount_usdstring required
recorded_atinteger required

Response

Return a 200 status to indicate that the webhook was received 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.