---
title: "Create a new Multicurrency Wallet."
method: POST
path: "/v0.2.4/multicurrency-wallets/create"
tags: ["MultiCurrency Wallets"]
---

# Create a new Multicurrency Wallet.

`POST /v0.2.4/multicurrency-wallets/create`

## Request body

- object
  - `name` string, required — Name of owner of Wallet.
  - `email` string — Email of owner of Wallet.
  - `firstName` string — First Name of owner.
  - `lastName` string — Last Name of owner.
  - `phoneNumber` string — Phone Number with country code starting with a +.
  - `meta` object — Metadata to store about the account.

## Response `200`

Success.

- object
  - `status` string
  - `message` string — Message indicating the result of the operation.
  - `data` object
    - `id` string — Unique identifier for the created sub-account.
    - `lastName` string — Last name of the sub-account owner.
    - `parent` string — Parent account ID.
    - `feePercent` number — Fee percentage for the sub-account.
    - `accountSecondCurrencies` string[] — List of secondary currencies associated with the account.
    - `verified` boolean — Whether the sub-account is verified.
    - `isScrimUser` boolean
    - `subAccount` boolean
    - `firstName` string
    - `preferredExchangeRate` boolean
    - `uid` string
    - `approved` boolean
    - `createdDate` string
    - `joinDate` string
    - `phoneNumber` string
    - `tier` object
      - `id` string
    - `meta` object
      - `email` string
    - `approvals` object[]
      - `changedFields` string[]
      - `deviceTime` string
      - `timestamp` string
    - `name` string
    - `apiUseEnabled` boolean
    - `email` string
    - `p_id` number
    - `verification` object
      - `status` string

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `403` — Access to this resource is forbidden.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)