---
title: "Create wallet"
method: POST
path: "/wallets"
tags: ["Wallets"]
---

# Create wallet

`POST /wallets`

Creates a new wallet for a customer or the authenticated account.

## Request body

- object
  - `currency` string, required — ISO 4217 currency code.
  - `customer_id` integer — Customer ID to assign the wallet to. Required unless `customer_type` is `source`.
  - `customer_type` 'source' | 'user' — Pass `source` to create a wallet for the authenticated account. Pass `user` for a customer wallet (use with `customer_id`).
  - `type` 'CURRENCYCLOUD' | 'CLEARJUNCTION' — Optional wallet provider type.
  - `tag` string
  - `metadata` object

## Response `200`

Wallet created

- Wallet
  - `id` integer
  - `self` string
  - `uuid` string
  - `type` string, nullable — Wallet provider type (e.g. `CLEARJUNCTION`, `CURRENCYCLOUD`). Null for standard wallets.
  - `balance` number, float
  - `currency` string
  - `tag` string, nullable
  - `metadata` object, nullable
  - `created_at` string, date-time, nullable
  - `connections` Connections — Hypermedia links to related resources.

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/truust-io/apis/truust-api.md) · [All operations](https://skmtc.net/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truust-io/truust-api/versions/cc81e28726b9/schema)