POST
/
wallets
curl --request POST \
  --url https://api.sulu.sh/v0/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ownedBy": "<string>",
  "currency": "<string>",
  "timezone": "<string>",
  "tag": "<string>",
  "initialBalance": "<string>",
  "name": "<string>",
  "description": "<string>",
  "legacy": {
    "isConsumer": true,
    "orgId": "<string>"
  }
}'
{
  "id": "<string>",
  "object": "wallet",
  "ownedBy": "<string>",
  "balance": 123,
  "currency": "<string>",
  "timezone": "<string>",
  "tag": "<string>",
  "createdAt": 123,
  "updatedAt": 123,
  "name": "<string>",
  "description": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ownedBy
string
required

Owner identifier

currency
string
required

ISO 4217 currency code

name
string
required

Display name for the account

timezone
string

IANA timezone (defaults to UTC)

tag
string

Optional tag for the account

initialBalance
string

Initial balance in the smallest currency unit (e.g. cents)

description
string

Optional description of the account

legacy
object

Optional legacy wallet mapping information

Response

201
application/json
Wallet created successfully
id
string

Unique account ID with acc_ prefix

object
enum<string>
default:wallet
Available options:
wallet
ownedBy
string

Owner identifier

balance
integer

Balance in nano dollars (1e-9 dollars)

currency
string

ISO 4217 currency code

timezone
string

IANA timezone

tag
string

Optional tag for the account

createdAt
integer

Creation timestamp (Unix nano)

updatedAt
integer

Last update timestamp (Unix nano)

name
string

Display name for the account

description
string

Optional description