---
title: "Add multiple users to team"
method: POST
path: "/user-service/teams/{teamId}/members/bulk"
tags: ["Teams"]
---

# Add multiple users to team

`POST /user-service/teams/{teamId}/members/bulk`

## Request

- Base URL: `https://api.firefly.ai/v2`
- URL: `https://api.firefly.ai/v2/user-service/teams/{teamId}/members/bulk`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/firefly/apis/firefly-user-management-service-api/docs/user-service/teams/:teamId/members/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

Add multiple users to the specified team in a single operation

## Request body

- object
  - `user_ids` string[], required: Array of user IDs to add to the team
  - `skip_existing` boolean: Skip users that are already in the team instead of returning error

## Response `201`

Users added to team successfully

- object
  - `message` string
  - `added_users` string[]: User IDs that were successfully added
  - `skipped_users` string[]: User IDs that were skipped (already in team)
  - `failed_users` object[]: User IDs that failed to be added with error reasons
    - `user_id` string, uuid
    - `error` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Team not found

---

[API](https://skmtc.dev/firefly/apis/firefly-user-management-service-api.md) - [All operations](https://skmtc.dev/firefly/apis/firefly-user-management-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firefly/apis/firefly-user-management-service-api/revisions/3d5d69795558?raw)