Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

​
privy-authorization-signature
string

Request authorization signature. If multiple signatures are required, they should be comma separated.

​
privy-request-expiry
string

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

​
privy-idempotency-key
string

Idempotency keys ensure API requests are executed only once within a 24-hour window.

Path Parameters

​
wallet_id
string
required

ID of the wallet.

Body

application/json

Creates a crypto deposit account from an existing deposit configuration.

​
type
enum<string>
required
Available options:
deposit_config
​
deposit_config_id
string
required
Minimum string length: 1
​
deposit_address_strategy
enum<string>

Controls deposit source selection. dedicated creates or reuses eligible dedicated source wallets, never the destination wallet. This is the default when omitted, including for existing routes. prefer_destination uses the destination wallet when it is eligible and its chain family is requested; otherwise it uses dedicated source wallets. require_destination requires the destination wallet to serve its own chain family when that family is requested and fails without fallback if it cannot; other requested families still use dedicated source wallets. On destination reuse, all strategies remove all existing automation attachments, including matching and disabled ones, then attach the requested automation. Exported wallets cannot serve as deposit sources.

Available options:
dedicated,
prefer_destination,
require_destination
Example:

"dedicated"

Response

200 - application/json

The created crypto deposit account.

Response returned after creating a crypto deposit account.

​
deposit_accounts
CryptoDepositAddressRoute · object[]
required