---
title: "create user with x-custom-token"
method: POST
path: "/v1/users/batch"
tags: ["Users"]
deprecated: true
---

# create user with x-custom-token

`POST /v1/users/batch`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/users/batch`
- Auth: HTTP bearer

> **Deprecated.**

**Deprecated**: use `/v2/users/batch` instead.

**Auth**: User JWT

## Path parameters

- `id` string, required

## Request body

- object
  - `bypassEmailConfirmation` boolean: If true, skip the email-verification step and create users immediately. Use when the importer has already verified ownership of the addresses (e.g. SSO migration). Default false.
  - `usersList` UserDataB2B[]: Array of users to create. Each entry needs at minimum `email`, `firstName`, `lastName`; `password` is optional (omitted users get a temporary password by email).
    - `email` string
    - `firstName` string
    - `lastName` string
    - `password` string
    - `uuid` string
    - `profileImage` string: Optional profile image URL.
    - `profileImageFileIndex` integer: Multipart-only: index into uploaded files[] to be uploaded and used as profileImage.

## Response `200`

```
{
  ok: boolean,
  results: [
     {
        defaultWallet: {
          walletAddress: string
        },
        _id: string,
        firstName: string,
        lastName: string,
        email: string,
        username: string,
        tags: string[],
        profileImage: string,
        emails: [
          {
            loginType: string,
            email: string,
            verified: boolean,
            _id: string
          }
        ],
        appId: string,
        xmppPassword: string,
        roles: string[],
        isProfileOpen: boolean,
        isAssetsOpen: boolean,
        isAgreeWithTerms: boolean,
        homeScreen: string,
        registrationChannelType: string,
        createdAt: string,
        updatedAt: string
      },
    }
  ]
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: ``` { error: 'Forbidden' } ```
- `404`: Not Found
- `422`: ``` { error: string } ```
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)