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

# Invite Users

`POST /v1/admin/users-invite`

Invite users to the Organization.

## Request body

- OrganizationInviteIN
  - `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, comma-separated emails, or newline-separated emails to invite.
  - `subscription_type` 'API' | 'CHAT' | 'ON_PREMISE' | 'LICENSE' | 'MISTRAL_CODE'
  - `subscription_types` PlanType[], nullable — Product seats to assign to invited users.
  - `subscription_seat_automatic_granting` boolean — Whether to grant subscription seats automatically.
  - `email_language` 'en' | 'fr' | 'es' | 'de' | 'it' | 'pt_br' | 'pl' | 'ar' | 'nl', nullable — Language used for invitation emails.
  - `workspace_uuids` string[], nullable — Workspace IDs the invited users should join.

## Response `200`

OK

- OrganizationInvitesCreateOUT
  - `invalid_emails` string[], required — Email addresses that could not be invited.
  - `already_members` string[], required — Email addresses that already belong to the Organization.
  - `invited_members_count` integer, nullable — Number of invitations successfully created.

---

[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)