---
title: "Send invitations via email"
method: POST
path: "/organizations/{orgId}/invitations/email"
tags: ["organizations"]
---

# Send invitations via email

`POST /organizations/{orgId}/invitations/email`

Allows an organization admin to invite users via email.

## Path parameters

- `orgId` string, uuid, required

## Request body

- SendInvitationsEmailRequest
  - `invitees` InviteeInfo[], required — List of invitees' email and role.
    - `email` string, required — The email address of the user to invite.
    - `role` 'org_user', required — The organization role assigned to the user.

## Response `201`

Successfully sent the invitations.

## Other responses

- `400` — - [group:**request**, code:**0**]: Invalid field in the request. - [group:**request**, code:**1**]: The request body is required.
- `404` — - [group:**organization**, code:**2**]: Organization does not exist.
- `409` — - [group:**invitation**, code:**0**]: The invitee already belongs to the organization.
- `500` — - [group:**email**, code:**0**]: Send email encountered error - [group:**invitation**, code:**200**]: Save invitation encountered error. - [group:**organization**, code:**1200**]: Get organization grouping policy encountered error. - [group:**organization**, code:**1201**]: Get organization encountered DB error. - [group:**user**, code:**1200**]: Get user encountered DB error.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)