---
title: "Invite Users"
method: POST
path: "/users"
tags: ["/users"]
---

# Invite Users

`POST /users`

Invite users to the tenant. This checks if the user is already in the tenant and if not, creates the user. We will return a list of user emails that were successfully created (including existing users).

## Request body

- InviteUsersRequest
  - `tenant_short_name` string, required — The short name of the tenant
  - `new_users` TenantNewUserInfo[], required — List of new users to be invited
    - `email` string, required — The email of the user
    - `is_tenant_admin` boolean — Flag indicating if the user is a tenant admin
    - `roles` UserRolesEnum[] — The user level roles of the user.

## Response `200`

Successful Response

- InviteUsersResponse
  - `invited_user_emails` string[], required — List of emails of the invited users
  - `error_details` object, required — Details of the errors occurred while inviting users, where keys are the emails and values are the error messages

## Other responses

- `422` — Validation Error

## Changes

- **2025-05-08** `17bdb8a33fb4` — 1 warning, 7 info
  - removed the request property `new_users/items/per_agent_roles`
  - added the new `CONTEXTUAL_EXTERNAL_STAFF_USER` enum value to the request property `new_users/items/roles/items/`
  - added the new `CONTEXTUAL_INTERNAL_STAFF_USER` enum value to the request property `new_users/items/roles/items/`
  - added the new `CONTEXTUAL_STAFF_USER` enum value to the request property `new_users/items/roles/items/`
  - …4 more
- **2025-02-08** `d79ccb778953` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/users/post.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/17bdb8a33fb4/schema)