Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Team

  • Create team member

  • Bulk create team members

  • Bulk update team members

  • List jobs

  • Create job

  • Retrieve job

  • Update job

  • Search team members

  • Retrieve team member

  • Update team member

  • Retrieve wage setting

  • Update wage setting

  • Webhooks

  • job.created

  • job.updated

  • team_member.created

  • team_member.updated

  • team_member.wage_setting.updated

<- Team API

Team API

All versions ->

Update team member

PUT

 /v2/team-members/{team_member_id}

Updates a single TeamMember object.

The TeamMember object is returned on successful updates. Learn about Troubleshooting the Team API.

Permissions:EMPLOYEES_WRITE

Guide

Update a team member

Try in API Explorer
Link to section

Path parameters

Example code

Link to section

team_member_id

string

Required

The ID of the team member to update.

Link to section

Request body

Link to section

team_member

The team member fields to add, change, or clear. Fields can be cleared using a null value. To update wage_setting.job_assignments, you must provide the complete list of job assignments. If needed, call ListJobs to get the required job_id values.

Link to section

Response fields

Link to section

team_member

The successfully updated TeamMember object.

Link to section

errors

The errors that occurred during the request.

Link to section

Examples

All versions ->

PUT /v2/team-members/{team_member_id}
curl https://connect.squareup.com/v2/team-members/1yJlHapkseYnNPETIU1B \ -X PUT \ -H 'Square-Version: 2026-11-18' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "team_member": { "reference_id": "reference_id_1", "status": "ACTIVE", "given_name": "Joe", "family_name": "Doe", "email_address": "[email protected]", "phone_number": "+14159283333", "assigned_locations": { "location_ids": [ "YSGH2WBKG94QZ", "GA2Y9HSJ8KRYT" ], "assignment_type": "EXPLICIT_LOCATIONS" }, "wage_setting": { "is_overtime_exempt": true, "job_assignments": [ { "job_id": "FjS8x95cqHiMenw4f1NAUH4P", "pay_type": "SALARY", "annual_rate": { "amount": 3000000, "currency": "USD" }, "weekly_hours": 40 }, { "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 1200, "currency": "USD" } } ] } } }'

Response JSON

{ "team_member": { "id": "1yJlHapkseYnNPETIU1B", "reference_id": "reference_id_1", "is_owner": false, "status": "ACTIVE", "given_name": "Joe", "family_name": "Doe", "email_address": "[email protected]", "phone_number": "+14159283333", "created_at": "2021-06-11T22:55:45Z", "updated_at": "2021-06-15T17:38:05Z", "assigned_locations": { "assignment_type": "EXPLICIT_LOCATIONS", "location_ids": [ "GA2Y9HSJ8KRYT", "YSGH2WBKG94QZ" ] }, "wage_setting": { "team_member_id": "1yJlHapkseYnNPETIU1B", "job_assignments": [ { "job_title": "Manager", "job_id": "FjS8x95cqHiMenw4f1NAUH4P", "pay_type": "SALARY", "hourly_rate": { "amount": 1443, "currency": "USD" }, "annual_rate": { "amount": 3000000, "currency": "USD" }, "weekly_hours": 40 }, { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 1200, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 1, "created_at": "2021-06-11T22:55:45Z", "updated_at": "2021-06-11T22:55:45Z" } } }

Error descriptions

400 Bad request

{ "errors": [ { "code": "INVALID_EMAIL_ADDRESS", "category": "INVALID_REQUEST_ERROR" } ] }