POST /users
Create a new user account via the API.
!!! warn ""
**Note**: On Zulip Cloud, this feature is available only for
organizations on a [Zulip Cloud Standard](https://zulip.com/plans/)
or [Zulip Cloud Plus](https://zulip.com/plans/) plan. Administrators
can request the required `can_create_users` permission for a bot or
user by contacting [Zulip Cloud support][support] with an
explanation for why it is needed. Self-hosted installations can
toggle `can_create_users` on an account using the `manage.py
change_user_role` [management command][management-commands].
Changes: Before Zulip 4.0 (feature level 36), this endpoint was available to all organization administrators.
Servers
- https://{subdomain}.zulipchat.com/api/v1
- {server}/api/v1
- https://chat.zulip.org/api/v1
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/x-www-form-urlencoded" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
email |
String | Yes |
The email address of the new user. |
full_name |
String | Yes |
The full name of the new user. |
password |
String | Yes |
The password of the new user. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.