Skip to main content
POST
/
api
/
wallets
/
wallets
Create a new wallet
curl --request POST \
  --url http://localhost/api/wallets/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {},
  "name": "<string>"
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "metadata": {},
    "name": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "ledger": "<string>",
    "balances": {
      "main": {
        "assets": {}
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.formance.com/llms.txt

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

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string

Use an idempotency key

Body

application/json
metadata
object
required

Custom metadata to attach to this wallet.

name
string
required

Response

Wallet created

data
object
required