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

# Invite users to a team

`POST /teams/{teamId}/memberships`

## Request

- Base URL: `https://connect.signl4.com/api`
- URL: `https://connect.signl4.com/api/teams/{teamId}/memberships`
- Auth: none required
- TypeScript: <https://skmtc.dev/signl4/apis/signl4-api-v1/docs/teams/:teamId/memberships/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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

## Changes

- **2025-05-16** `80a3a05166d4`: 8 breaking, 20 info
  - the request property `invites` became not nullable (media type: application/json-patch+json)
  - the request property `invites` became not nullable (media type: application/json)
  - the request property `invites` became not nullable (media type: text/json)
  - the request property `invites` became not nullable (media type: application/*+json)
  - …24 more

[Operation history](https://skmtc.dev/signl4/apis/signl4-api-v1/changes/teams/:teamId/memberships/post.md)

---

[API](https://skmtc.dev/signl4/apis/signl4-api-v1.md) - [All operations](https://skmtc.dev/signl4/apis/signl4-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/signl4/apis/signl4-api-v1/revisions/bf9d377a0764?raw)