---
title: "Create Users"
method: POST
path: "/v1/admin/users"
tags: ["beta.admin.users"]
---

# Create Users

`POST /v1/admin/users`

Create Organization members.

## Request body

- OrganizationMemberCreate[]
  - `role_names` string[], nullable — Simplified role names to assign. Mutually exclusive with 'roles'.
  - `roles` union — Role values to assign. Mutually exclusive with 'role_names'.
    - UserRole[]
    - StaticOrganizationRoles[]
  - `role_name` 'member' | 'billing_manager' | 'organization_admin', nullable — Deprecated single role name, kept for backward compatibility. Mutually exclusive with 'role'.
  - `role` union — Deprecated legacy single role value, kept for backward compatibility. Mutually exclusive with 'role_name'.
    - 'A' | 'M' | 'B'
    - '0d48f530-095c-43fe-8aea-6673bcacabe6' | 'c955f4e1-9477-43f0-8349-6fbc629fccc9' | '7bde5959-d676-47d2-b779-35b64323d278'
  - `email` string, required — Email address of the user to create.
  - `first_name` string, required — First name of the user to create.
  - `last_name` string, required — Last name of the user to create.
  - `subscription_types` PlanType[], nullable — Product seats to assign to the user.

## Response `200`

OK

- OrganizationUsersCreateOUT
  - `invalid_emails` string[], required — Email addresses that could not be created.
  - `email_to_user_id` object, required — Mapping from created user email to user identifier.

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)