---
title: "Invite User"
method: POST
path: "/v1/users/invite"
tags: ["Identity"]
---

# Invite User

`POST /v1/users/invite`

Invite user

## Request body

- UserInviteRequest
  - `email` string, required — Email ID of the user. This wil be unique across all the CoreStack accounts
  - `tenants` UserInviteTenantRoles[], required — List of roles assignments for the user. The same user can be assigned different roles in different tenants
    - `tenant_id` string, required — ID of the tenant within the CoreStack account
    - `role_ids` string[], required — Ids of the Roles to be assigned to the user under a tenant
  - `master_account_id` string, required — ID of the Account Master in CoreStack
  - `user_groups` string[]

## Response `201`

Created

- UserInviteResponse
  - `user_id` string — ID of the newly invited User

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)