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>",
      "chain_type": "ethereum",
      "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.