---
title: "Transfer created"
method: POST
path: "wallet_action.transfer.created"
---

# Transfer created

`POST wallet_action.transfer.created` (webhook)

Fired when a wallet action is created and execution has begun. The action is now pending.

## Payload

- WalletActionTransferCreatedWebhookPayload — Payload for the wallet_action.transfer.created webhook event.
  - `action_type` 'swap' | 'transfer' | 'earn_deposit' | 'earn_withdraw' | 'earn_incentive_claim' | 'earn_fee_collect', required — Type of wallet action
  - `created_at` string, required — ISO 8601 timestamp of when the wallet action was created.
  - `destination_address` string, required — Recipient address.
  - `source_amount` string — Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output cross-chain transfers until the source amount is determined.
  - `source_asset` string — Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated with a named asset; omitted for custom-token transfers.
  - `source_asset_address` string — Token contract address (EVM) or mint address (Solana). Present when the transfer was initiated with `asset_address`.
  - `source_asset_decimals` integer — Number of decimals for the transferred token. Present when the transfer was initiated with `asset_address` and the decimals were resolved onchain.
  - `source_chain` string, required — Chain name (e.g. "base", "ethereum").
  - `status` 'pending', required — The status of the wallet action.
  - `type` 'wallet_action.transfer.created', required — The type of webhook event.
  - `wallet_action_id` string, required — The ID of the wallet action.
  - `wallet_id` string, required — The ID of the wallet involved in the action.

## Acknowledgement `200`

Return a 200 status to indicate that the webhook was received successfully.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)