> For the complete documentation index, see [llms.txt](https://docs.delos.financial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.delos.financial/accounts/create-account.md). # Create account This command is to create an account (payment wallet) for a specific customer. Creates a new account with the specified currency and owner. Returns the newly created account details, including balance **Endpoint** `POST/v2/account` **Link** {% embed url="" %} ### **Request** #### **Headers** | Key | Value | Required | | --------------- | ------------------ | -------- | | `Authorization` | `Bearer ` | Yes | | `Content-Type` | `application/json` | Yes | | `Accept` | `application/json` | Yes | #### **Request Body (JSON)** | Field | Type | Description & Requirements | Example | | ----------------- | -------- | ------------------------------------------------------------- | ---------------------------------- | | **`customerId`** | `string` | **ID of the customer** who owns this account. | `"DqCsgSE-4e95-ViYbNI"` | | **`name`** | `string` | **Account name** (e.g., `"Business USD Account"`). | `"Savings Account"` | | **`currencyIso`** | `string` | **Currency code** (ISO 4217, e.g., `USD`, `EUR`). *Required*. | `"EUR"` | **Example Request Body:** json ``` { "customerId": "DqCsgSE-4e95-ViYbNI", "name": "Main Business Account", "currencyIso": "USD" } ``` *** ### **Response (200 OK)** Returns the created `Account entity v2` object in JSON format. #### **Response Fields** | Field | Type | Description & Values | Example | | ----------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | **`id`** | `string` | Unique account identifier. | `"UhcPVBEpjmtR"` | | **`customer`** | `object` |

Customer details:
- id: Customer ID
- name: Full name
- email: Contact email
- phone: Phone number
- status: Customer status (NEW, ACCEPT, etc.)

| `{ "id": "``DqCsgSE-4e95-ViYbNI``", "status": "NEW" }` | | **`isDefault`** | `boolean` | Whether this is the user’s default account (`true`/`false`). | `false` | | **`name`** | `string` | Account name (matches request). | `"Main Business Account"` | | **`status`** | `string` |

Initial account status:
- NEW: Newly created
- PRE\_MODERATION: Pending review
- MODERATION: Under review

| `"NEW"` | | **`balance`** | `object` |

Balance details (initially zero):
- balance: Available funds
- hold: Restricted funds (see Money Object below)

| – | | **`currencyIso`** | `string` | Account currency (matches request). | `"USD"` | | **`requisites`** | `array` | **Bank/payment details** (empty by default). | `[]` | | **`createdAt`** | `string` | Creation timestamp (ISO 8601). | "2024-05-20T10:30:00Z" | | **`updatedAt`** | `string` | Last update timestamp (matches `createdAt` initially). | "2024-05-20T10:30:00Z" | **Money Object** Nested under `balance` and `hold`: | Field | Type | Description | Example | | ------------------ | --------- | ------------------------------------------------------- | ------- | | **`currencyCode`** | `string` | 3-letter ISO currency code. | `"USD"` | | **`units`** | `string` | Whole units (e.g., dollars). Initially `"0"`. | `"0"` | | **`nanos`** | `integer` | Fractional units (1 nano = 10^-9 units). Initially `0`. | `0` | ### Error Cases 1. **Missing `currencyIso`**: json ``` { "error": "currencyIso is required" } ``` 2. **Invalid Currency Code**: json ``` { "error": "currencyIso must be a valid ISO 4217 code (e.g., USD, EUR)" } ``` 3. **Customer Not Found**: json ``` { "error": "customerId not found" } ``` *** ### **Notes** * **Initial Status:** New accounts typically start with `NEW` status. If needed, the status can be changed to MODERATION status * **Balances**: Initialized to `0` in the specified currency. * **Requisites**: Added later via separate API calls (e.g., `/v2/account/{id}/requisites`). ### Examples **Real request** ```postman_json { "customerId": "DqCsgSE-4e95-ViYbNI7mudVE", "name": "Savings Account", "currencyCode": "EUR" } ``` **Real response** ```postman_json 200 OK { "item": { "accountId": "E4eon5o2Ehnz", "customer": { "id": "DqCsgSE-4e95-ViYbNI7mudVE", "name": "", "email": "", "phone": "", "status": "NEW" }, "isDefault": false, "name": "Savings Account", "status": "MODERATION", "balance": { "balance": { "money": { "currencyCode": "EUR", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } }, "hold": { "money": { "currencyCode": "EUR", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } } }, "currencyCode": "EUR", "requisites": [], "createdAt": "0001-01-01T00:00:00Z", "updatedAt": "0001-01-01T00:00:00Z" } } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.delos.financial/accounts/create-account.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.