---
title: "BulkUpdateTeamMembers"
method: POST
path: "/v2/team-members/bulk-update"
tags: ["Team"]
---

# BulkUpdateTeamMembers

`POST /v2/team-members/bulk-update`

Updates multiple `TeamMember` objects. The updated `TeamMember` objects are returned on successful updates.
This process is non-transactional and processes as much of the request as possible. If one of the updates in
the request cannot be successfully processed, the request is not marked as failed, but the body of the response
contains explicit error information for the failed update.
Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-update-team-members).

## Request body

- BulkUpdateTeamMembersRequest — Represents a bulk update request for `TeamMember` objects.
  - `team_members` object, required — The data used to update the `TeamMember` objects. Each key is the `team_member_id` that maps to the `UpdateTeamMemberRequest`.

## Response `200`

Success

- BulkUpdateTeamMembersResponse — Represents a response from a bulk update request containing the updated `TeamMember` objects or error messages.
  - `errors` Error[] — The errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `team_members` object — The successfully updated `TeamMember` objects. Each key is the `team_member_id` that maps to the `UpdateTeamMemberRequest`.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)