> For the complete documentation index, see [llms.txt](https://docs.ezeebit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ezeebit.com/customer-accounts/create-customer-account.md).

# Create Customer Account

Open a USDT account for one of your customers, with deposit addresses on four networks.

**Live:**

<mark style="color:green;">`POST`</mark> [<mark style="color:blue;">https://api.ezeebit.com/open/api/v1/customerAccount/create</mark>](https://api.ezeebit.com/open/api/v1/customerAccount/create)

**UAT:**

<mark style="color:green;">`POST`</mark> [<mark style="color:blue;">https://uat-api.ezeebit.com/open/api/v1/customerAccount/create</mark>](https://uat-api.ezeebit.com/open/api/v1/customerAccount/create)

## Headers

| Name                   | Type   | Required | Value                          |
| ---------------------- | ------ | -------- | ------------------------------ |
| Content-Type           | string | Y        | application/json               |
| Ezeebit-Timestamp      | long   | Y        | Unix timestamp in milliseconds |
| Ezeebit-Nonce          | string | Y        | 32 characters                  |
| Ezeebit-Certificate-SN | string | Y        | API key issued by Ezeebit Pay  |
| Ezeebit-Signature      | string | Y        | Uppercase SHA512 signature     |

## Request Body

```json
{
  "customerAccountId": "cust-1001",
  "accountName": "Customer 1001"
}
```

## Form data

| Parameter         | Type   | Required | Description                                                                                         |
| ----------------- | ------ | -------- | --------------------------------------------------------------------------------------------------- |
| customerAccountId | string | No       | Your own ID for this customer, at most **64 characters**. Omit it and we generate a UUID.           |
| accountName       | string | No       | A label for your own reference, at most **128 characters**. It is never used to look an account up. |

The call is idempotent on `customerAccountId`. Send an ID you have already used and you get that account back as it is — no second account, and `accountName` is not changed.

Every account is opened with USDT deposit addresses on Ethereum, BSC, Tron, and Solana. Ethereum and BSC share one address. Deposits to these addresses are credited to the customer account, not to your own balance. An address can be replaced, so read the current ones from [Customer Account Details](https://docs.ezeebit.com/customer-accounts/customer-account-details.md) whenever you show them to your customer.

## Response

| Status | Description                                       |
| ------ | ------------------------------------------------- |
| 200    | Account created, or the existing account returned |
| 400    | A field is too long. `msg` names the field        |

### Response fields

<table><thead><tr><th width="260">Field</th><th width="90">Type</th><th>Description</th></tr></thead><tbody><tr><td>customerAccountId</td><td>string</td><td>Your ID, or the one we generated</td></tr><tr><td>accountName</td><td>string</td><td>Your label, or <code>null</code></td></tr><tr><td>status</td><td>string</td><td><code>ACTIVE</code>, or <code>FROZEN</code> if Ezeebit has frozen the account. A frozen account still receives deposits but can't convert, transfer, or withdraw</td></tr><tr><td>wallets</td><td>array</td><td>One entry per asset. USDT is the only asset today</td></tr><tr><td>wallets[].walletId</td><td>string</td><td>ID of the customer's USDT wallet. Movements on it carry this <code>walletId</code> on the <a href="https://docs.ezeebit.com/wallets-and-withdrawal/wallet-webhook.md">Wallet Webhook</a></td></tr><tr><td>wallets[].unit</td><td>string</td><td><code>USDT</code></td></tr><tr><td>wallets[].balance</td><td>string</td><td>Available balance</td></tr><tr><td>wallets[].depositAddresses</td><td>array</td><td>One entry per network: <code>chainType</code>, which is <code>TRX</code>, <code>ETH</code>, <code>BSC</code> or <code>SOL</code>, and its <code>address</code></td></tr></tbody></table>

{% tabs %}
{% tab title="200" %}

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "customerAccountId": "cust-1001",
    "accountName": "Customer 1001",
    "status": "ACTIVE",
    "wallets": [
      {
        "walletId": "5d0c7e2a-4b1f-4c8e-9a3d-2f6b8e1c4a70",
        "unit": "USDT",
        "balance": "0.00000000",
        "depositAddresses": [
          {
            "chainType": "TRX",
            "address": "TQ8nJ5bL2wVxK3pR7mYcH4dF9gS6tA1kPd"
          },
          {
            "chainType": "ETH",
            "address": "0x7a3f5e2b9c1d4a6e8f0b2c4d6e8a0b1c3d5ec91e"
          },
          {
            "chainType": "BSC",
            "address": "0x7a3f5e2b9c1d4a6e8f0b2c4d6e8a0b1c3d5ec91e"
          },
          {
            "chainType": "SOL",
            "address": "5hT3qLm8vXcR2nKp9dWf6yBzJa4sE7uGtN1oH8iCkVxQ"
          }
        ]
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}
