---
title: "CreateTeamMember"
method: POST
path: "/v2/team-members"
tags: ["Team"]
---

# CreateTeamMember

`POST /v2/team-members`

Creates a single `TeamMember` object. The `TeamMember` object is returned on successful creates.
You must provide the following values in your request to this endpoint:
- `given_name`
- `family_name`

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

## Request body

- CreateTeamMemberRequest — Represents a create request for a `TeamMember` object.
  - `idempotency_key` string — A unique string that identifies this `CreateTeamMember` request. Keys can be any valid string, but must be unique for every request. For more information, see [Idempotency](https://developer.squareup.com/docs/basics/api101/idempotency). The minimum length is 1 and the maximum length is 45.
  - `team_member` TeamMember — A record representing an individual team member for a business.
    - `assigned_locations` TeamMemberAssignedLocations — An object that represents a team member's assignment to locations.
      - `assignment_type` string — The current assignment type of the team member.
      - `location_ids` string[] — The locations that the team member is assigned to.
    - `created_at` string — The timestamp, in RFC 3339 format, describing when the team member was created. For example, "2018-10-04T04:00:00-07:00" or "2019-02-05T12:00:00Z".
    - `email_address` string — The email address associated with the team member.
    - `family_name` string — The family name (that is, the last name) associated with the team member.
    - `given_name` string — The given name (that is, the first name) associated with the team member.
    - `id` string — The unique ID for the team member.
    - `is_owner` boolean — Whether the team member is the owner of the Square account.
    - `phone_number` string — The team member's phone number, in E.164 format. For example: +14155552671 - the country code is 1 for US +551155256325 - the country code is 55 for BR
    - `reference_id` string — A second ID used to associate the team member with an entity in another system.
    - `status` string — Describes the status of the team member.
    - `updated_at` string — The timestamp, in RFC 3339 format, describing when the team member was last updated. For example, "2018-10-04T04:00:00-07:00" or "2019-02-05T12:00:00Z".

## Response `200`

Success

- CreateTeamMemberResponse — Represents a response from a create request containing the created `TeamMember` object 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_member` TeamMember — A record representing an individual team member for a business.
    - `assigned_locations` TeamMemberAssignedLocations — An object that represents a team member's assignment to locations.
      - `assignment_type` string — The current assignment type of the team member.
      - `location_ids` string[] — The locations that the team member is assigned to.
    - `created_at` string — The timestamp, in RFC 3339 format, describing when the team member was created. For example, "2018-10-04T04:00:00-07:00" or "2019-02-05T12:00:00Z".
    - `email_address` string — The email address associated with the team member.
    - `family_name` string — The family name (that is, the last name) associated with the team member.
    - `given_name` string — The given name (that is, the first name) associated with the team member.
    - `id` string — The unique ID for the team member.
    - `is_owner` boolean — Whether the team member is the owner of the Square account.
    - `phone_number` string — The team member's phone number, in E.164 format. For example: +14155552671 - the country code is 1 for US +551155256325 - the country code is 55 for BR
    - `reference_id` string — A second ID used to associate the team member with an entity in another system.
    - `status` string — Describes the status of the team member.
    - `updated_at` string — The timestamp, in RFC 3339 format, describing when the team member was last updated. For example, "2018-10-04T04:00:00-07:00" or "2019-02-05T12:00:00Z".

---

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