---
title: "Add members to a team"
method: POST
path: "/v3/teams/{teamId}/users"
tags: ["v3 team members"]
---

# Add members to a team

`POST /v3/teams/{teamId}/users`

Add multiple members to a team, when the user is added an invite will be sent to their email. Their `status` will be set to `invited`.

The authenticated user has to be either the "administrator" or a "manager" of the team.

## Request body

- object
  - `users` object[]
    - `email` string
    - `role` 'manager' | 'monitor'

## Response `200`

Example response

- object
  - `data` object[], required
    - `id` string, required
    - `type` string, required
    - `attributes` TeamUserRelation, required
      - `teamId` string, required
      - `userId` string
      - `email` string, email, required
      - `role` 'administrator' | 'manager' | 'monitor' | 'left', required
      - `status` 'confirmed' | 'invited' | 'declined', required
      - `name` string

## Other responses

- `400` — Error Response
- `401` — Error Response
- `404` — Error Response

---

[API](https://skmtc.net/wri/apis/fw-teams.md) · [All operations](https://skmtc.net/wri/apis/fw-teams/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wri/fw-teams/revisions/9e208e657f30/schema)