Skip to main content
POST
/
v1
/
users
/
{user_id}
/
fiat
/
accounts
Create a fiat account
curl --request POST \
  --url https://api.privy.io/v1/users/{user_id}/fiat/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '
{
  "provider": "bridge-sandbox",
  "account_owner_name": "John Doe",
  "currency": "usd",
  "bank_name": "Chase",
  "account": {
    "account_number": "1234567899",
    "routing_number": "121212121",
    "checking_or_savings": "checking"
  },
  "address": {
    "street_line_1": "123 Washington St",
    "street_line_2": "Apt 2F",
    "city": "New York",
    "state": "NY",
    "postal_code": "10001",
    "country": "USA"
  },
  "first_name": "John",
  "last_name": "Doe"
}
'
{
  "id": "a068d2dd-743a-4011-9b62-8ad33cc7a7be",
  "bank_name": "Chase",
  "currency": "usd",
  "account_type": "us",
  "last_4": "7899"
}

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.

Path Parameters

​
user_id
string
required

The ID of the user to create the fiat account for

Body

application/json
​
provider
enum<string>
required

Valid set of onramp providers

Available options:
bridge,
bridge-sandbox
Example:

"bridge"

​
account_owner_name
string
required
Required string length: 3 - 256
​
currency
enum<string>
required

Supported fiat currencies.

Available options:
usd,
eur
​
bank_name
string
Required string length: 3 - 256
​
iban
object
​
account
object
​
swift
object
​
address
object
​
first_name
string
Required string length: 1 - 1024
​
last_name
string
Required string length: 1 - 1024

Response

200 - application/json

Created fiat account details

​
id
string
required
​
currency
string
required
​
account_type
string
required
​
bank_name
string
​
last_4
string