---
title: "Add team members"
method: POST
path: "/teams/{teamId}/members"
tags: ["Teams"]
---

# Add team members

`POST /teams/{teamId}/members`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/teams/{teamId}/members`
- Auth: none declared

Add up to 100 active organization members to a team atomically. Existing memberships are unchanged and previously removed memberships are restored.

## Path parameters

- `teamId` string, uuid, required: Team to add the members to.

## Request body

- object
  - `organizationId` string: Organization to operate on. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).
  - `userIds` string[], required: User IDs of active organization members to add. Duplicates are ignored.

## Response `201`

OK

- object
  - `ids` string[], required: IDs of the active team memberships, including existing members.

## Changes

- **2026-10-09** `015331799ce1`: 2 breaking, 1 warning, 1 info
  - added the new required request property `userIds`
  - removed the required property `id` from the response with the `201` status
  - removed the request property `userId`
  - added the required property `ids` to the response with the `201` status

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/teams/:teamId/members/post.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)