Update wage setting

PUT

/v2/team-members/{team_member_id}/wage-setting

Creates or updates a WageSetting object.

The object is created if a WageSetting with the specified team_member_id doesn't exist. Otherwise, it fully replaces the WageSetting object for the team member. The WageSetting is returned on a successful update. For more information, see Troubleshooting the Team API.

Square recommends using CreateTeamMember or UpdateTeamMember to manage the TeamMember.wage_setting field directly.

Permissions:EMPLOYEES_WRITE

Guide

Assign a job title and wage

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 for which to update the WageSetting object.

Link to section

Request body

Link to section

wage_setting

WageSetting

Required

The complete WageSetting object. For all job assignments, specify one of the following:

job_id (recommended) - If needed, call ListJobs to get a list of all jobs. Requires Square API version 2024-12-18 or later.
job_title - Use the exact, case-sensitive spelling of an existing title unless you want to create a new job. This value is ignored if job_id is also provided.

Show attributes

Link to section

Response fields

Link to section

wage_setting

WageSetting

The successfully updated WageSetting object.

Show attributes

Link to section

errors

Error[ ]

The errors that occurred during the request.

Show attributes

Link to section

Examples

API version2026-08-19

All versions ->

PUT/v2/team-members/{team_member_id}/wage-setting

cURL

curl https://connect.squareup.com/v2/team-members/-3oZQKPKVk6gUXU_V5Qa/wage-setting \
  -X PUT \
  -H 'Square-Version: 2026-08-19' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "wage_setting": {
      "is_overtime_exempt": true,
      "job_assignments": [
        {
          "job_title": "Manager",
          "pay_type": "SALARY",
          "annual_rate": {
            "amount": 3000000,
            "currency": "USD"
          },
          "weekly_hours": 40
        },
        {
          "job_title": "Cashier",
          "pay_type": "HOURLY",
          "hourly_rate": {
            "amount": 2000,
            "currency": "USD"
          }
        }
      ]
    }
  }'

Response JSON

{
  "wage_setting": {
    "team_member_id": "-3oZQKPKVk6gUXU_V5Qa",
    "job_assignments": [
      {
        "job_title": "Manager",
        "pay_type": "SALARY",
        "hourly_rate": {
          "amount": 1443,
          "currency": "USD"
        },
        "annual_rate": {
          "amount": 3000000,
          "currency": "USD"
        },
        "weekly_hours": 40
      },
      {
        "job_title": "Cashier",
        "pay_type": "HOURLY",
        "hourly_rate": {
          "amount": 2000,
          "currency": "USD"
        }
      }
    ],
    "is_overtime_exempt": true,
    "version": 1,
    "created_at": "2019-07-10T17:26:48+00:00",
    "updated_at": "2020-06-11T23:12:04+00:00"
  }
}