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

## Request

- Base URL: `https://api.resourcewatch.org`
- URL: `https://api.resourcewatch.org/v3/teams/{teamId}/users`
- Auth: HTTP bearer

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

## Changes

- **2022-07-01** `dcbff9c77fe8`: 1 info
  - added the optional property `data/items/attributes/name` to the response with the `200` status
- **2022-05-19** `4bc9eb243ae0`: 4 info
  - the response property `data` became required for the status `200`
  - the response property `data/items/attributes` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/type` became required for the status `200`
- **2022-05-06** `cb58e9551bce`: 1 breaking, 1 info
  - the request's body type changed from `array` to `object`
  - added the new optional request property `users`
- **2022-05-05** `9de002b42c17`: 2 info
  - api tag `v3 team members` added
  - api tag `v3` removed
- **2022-04-29** `318e32d5b89c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wri/apis/fw-teams/changes/v3/teams/:teamId/users/post.md)

---

[API](https://skmtc.dev/wri/apis/fw-teams.md) - [All operations](https://skmtc.dev/wri/apis/fw-teams/llms.txt) - [OpenAPI document](https://skmtc.dev/wri/apis/fw-teams/revisions/9e208e657f30?raw)