Skip to main content
POST
/
v1
/
accounts
Create account
curl --request POST \
  --url https://api.privy.io/v1/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '
{
  "display_name": "My Account",
  "wallets_configuration": [
    {
      "chain_type": "ethereum"
    }
  ]
}
'
{
  "id": "<string>",
  "display_name": "<string>",
  "wallets": [
    {
      "id": "<string>",
      "address": "<string>",
      "custody": {
        "provider": "<string>",
        "provider_user_id": "<string>"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.privy.io/llms.txt

Use this file to discover all available pages before exploring further.

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-idempotency-key
string

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

Body

application/json

Input for creating a digital asset account from new wallets with a wallets_configuration specification.

​
wallets_configuration
AccountWalletConfigurationItem · object[]
required

Configuration for the wallets on this account.

Required array length: 1 - 5 elements
​
display_name
string

An optional display name for the account.

Response

200 - application/json

The created account.

A digital asset account that groups wallets under a single entity.

​
id
string
required

The account ID.

​
display_name
string | null
required

An optional display name for the account.

​
wallets
AccountWallet · object[]
required

The wallets belonging to this account.