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

# BulkCreateTeamMembers

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

Creates multiple `TeamMember` objects. The created `TeamMember` objects are returned on successful creates.
This process is non-transactional and processes as much of the request as possible. If one of the creates 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 create.

Learn about [Troubleshooting the Team API](https://developer.squareup.com/docs/team/troubleshooting#bulk-create-team-members).

## Request body

- BulkCreateTeamMembersRequest — Represents a bulk create request for `TeamMember` objects.
  - `team_members` object, required — The data used to create the `TeamMember` objects. Each key is the `idempotency_key` that maps to the `CreateTeamMemberRequest`.

## Response `200`

Success

- BulkCreateTeamMembersResponse — Represents a response from a bulk create request containing the created `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 created `TeamMember` objects. Each key is the `idempotency_key` that maps to the `CreateTeamMemberRequest`.

---

[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)