---
title: "Create User"
method: POST
path: "/v4/organizations/{organizationId}/users"
tags: ["Users"]
---

# Create User

`POST /v4/organizations/{organizationId}/users`

Invites a new user under the organization.

After making a REST API request, an invitation email is triggered and sent to the user.
Upon receiving the invitation email, the user is required to click on a provided URL, which will redirect them to a page with a user interface (UI) where they can set their username and password.

The modification of any personal information related to a user can only be performed by the user through the UI.
Similarly, the user can solely conduct password updates through the UI.

The "caller" possessing Organization Owner access rights retains the exclusive user creation capability.
They hold the authority to assign roles at the organization and project levels.

At present, our support is limited to the resourceType of "project" exclusively.

In order to access this endpoint, the provided API key must have the following role:
- Organization Owner

To learn more, see [Organization Roles](https://docs.couchbase.com/cloud/organizations/organization-user-roles.html).

## Request body

- CreateUserRequest
  - `name` string — The name of the user.
  - `email` string, required — Email of the user.
  - `organizationRoles` OrganizationRoles[], required
  - `resources` Resource[]
    - `type` 'project' — Type of the resource.
    - `id` string, uuid, required — Id of the project.
    - `roles` ProjectRoles[], required

## Response `201`

Successfully sent invite to the user.

- CreateUserResponse
  - `id` string — The UUID of the user created.

## Other responses

- `400` — Returned when we are unable to decode the recevied payload.
- `403` — The client does not have the necessary permissions to access this resource.
- `404` — The requested resource was not found.
- `422` — Request validation error.
- `429` — Returned when the client exceeds the rate limit for the given APIKey.
- `500` — An unexpected error occurred in the server while processing this request.

---

[API](https://skmtc.net/couchbase/apis/couchbase-capella-management-api.md) · [All operations](https://skmtc.net/couchbase/apis/couchbase-capella-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/couchbase/couchbase-capella-management-api/revisions/e67df5d1f74e/schema)