> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/llms.txt)

# Create New Users

> POST /profiles/{profile_id}/users



## Servers
- https://api.iformbuilder.com/exzact/api/v81/[servername]: https://api.iformbuilder.com/exzact/api/v81/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile



### Body: application/json (object)

- **username** (string)

- **password** (string)
  At least 8 characters (the minimum is configurable per server).
  Servers with password complexity enabled also require an uppercase letter,
  a lowercase letter, a number, and one of `` !@#$%^&*()-_=+~`,. ``. Servers that
  enforce password history reject a previously used password.
  ZIM-integrated servers also enforce ZIM's policy: at least 8 characters
  with an uppercase letter, a lowercase letter, and a number.
  A user whose password fails validation is not created. Its `error_message`
  is `Parameter 'Password' is invalid` (ZIM's own error text on
  ZIM-integrated servers). The response is 400 if every user in the request
  fails, otherwise 207.

- **first_name** (string)

- **last_name** (string)

- **email** (string)

- **role** (string)
  must match "server", "company" or "basic"

  Defaults to `basic` when omitted. Only a Server Admin can create a `server` user.
  Every `can_*` flag defaults to `false` when omitted. The `company` and `server` roles
  still grant their preset permissions whatever the flags say.

- **can_form_edit** (boolean)

- **can_thunderplug_sync** (boolean)

- **can_assign** (boolean)
  Record Assignment. Company Admins and Server Admins always have it; set it to
  give it to a basic user.
  On ZIM-integrated servers a grant made here survives detaching the ZIM
  Record Assignment policy.

- **can_edit_records** (boolean)
  Edit Records. Lets the user edit records on forms they can view.
  On ZIM-integrated servers the user's ZIM policies grant or revoke this permission,
  and replace a value sent here at the user's next sign-in.

- **can_delete_records** (boolean)
  Delete Records. Lets the user delete records on forms they can view.
  On ZIM-integrated servers the user's ZIM policies grant or revoke this permission,
  and replace a value sent here at the user's next sign-in.

- **can_manage_templates** (boolean)
  Manage Document Templates. Lets the user create, edit and delete document templates.
  On ZIM-integrated servers the user's ZIM policies grant or revoke this permission,
  and replace a value sent here at the user's next sign-in.

- **can_generate_documents** (boolean)
  Generate Documents. Lets the user generate documents from document templates.
  On ZIM-integrated servers the user's ZIM policies grant or revoke this permission,
  and replace a value sent here at the user's next sign-in.



## Responses
### 201
Created

#### Body: application/json (object)
- **id** (number)
  the created user id


### 400
Bad Request


[Powered by Bump.sh](https://bump.sh)
