---
title: "If the user has the appropriate ACL, they can create other users for the application with the ID passed as a parameter"
method: POST
path: "/v1/users/create-with-app-id/{id}"
tags: ["Users"]
---

# If the user has the appropriate ACL, they can create other users for the application with the ID passed as a parameter

`POST /v1/users/create-with-app-id/{id}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/users/create-with-app-id/{id}`
- Auth: HTTP bearer

**Auth**: User JWT

## Path parameters

- `id` string, required

## Request body

- object
  - `email` string: New user's email address. Must be unique under this app.
  - `firstName` string: Given name shown in chat / profile.
  - `lastName` string: Family name shown in chat / profile.
  - `password` string: Optional. When supplied, it becomes the new user's *permanent* password (bcrypt-hashed): they sign in with it directly and no invite email is sent, since the caller is delivering the credential itself. When omitted, the server mints a temporary password, mails it out, and the user exchanges it for a permanent one via `/v1/users/set-permanent-password-with-temp-password`.

## Response `200`

```
{
  user: {
    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)