---
title: "Invite users to a team"
method: POST
path: "/teams/{teamId}/memberships"
tags: ["Teams"]
---

# Invite users to a team

`POST /teams/{teamId}/memberships`

## Path parameters

- `teamId` string, required

## Request body

- V1UsersInvitation
  - `inviterId` string, nullable
  - `invites` V1UserInvite[], required
    - `email` string, nullable
    - `roleId` string, nullable

## Response `200`

User invitation results are returned.

- V1UserInvitationResult[]
  - `errorCode` integer, nullable
  - `errorMessage` string, nullable
  - `invitedUser` V1InvitedUserInfo
    - `id` string, nullable
    - `name` string, nullable
    - `isInvite` boolean
    - `mail` string, nullable
    - `roleId` string, nullable
  - `success` boolean

## Other responses

- `204` — Request was canceled.
- `400` — Required parameters or authentication info could not be found in the request/claims.
- `403` — You're not allowed to request the access all required entities.
- `404` — Required entities could not be found in the database.
- `500` — Internal Server Error

---

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