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

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.net/firefly/apis/firefly-user-management-service-api.md) · [All operations](https://skmtc.net/firefly/apis/firefly-user-management-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/firefly-user-management-service-api/revisions/3d5d69795558/schema)