---
updatedAt: 2026-04-27T15:52:51.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Update Local Tax

Update Local Tax sends updated local tax code information for the selected employee.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "WebLink API",
    "description": "For documentation about this API, please visit https://developer.paylocity.com/integrations/reference/weblink-overview",
    "contact": {
      "email": "webservices@paylocity.com"
    },
    "version": "v2"
  },
  "servers": [
    {
      "url": "https://dc1demogw.paylocity.com/api"
    }
  ],
  "paths": {
    "/v1/companies/{companyId}/employees/{employeeId}/localTaxes/{taxCode}": {
      "put": {
        "tags": [
          "Local Tax"
        ],
        "summary": "Update Local Tax",
        "description": "Update Local Tax sends updated local tax code information for the selected employee.",
        "x-explorer-enabled": false,
        "operationId": "updateLocalTax",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Bearer + JWT",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "companyId",
            "in": "path",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n                **Allowable Values:**\r\n                9 char max",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "employeeId",
            "in": "path",
            "description": "The Paylocity Employee ID. This is a unique value per Paylocity Company ID.\r\n**Allowable Values:**\r\n10 char max",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taxCode",
            "in": "path",
            "description": "Tax Code",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "localTax Model (Note: taxCode can be included in the localTax model but will be ignored)",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/localTax"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Successfully Updated",
            "content": {}
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {}
          },
          "404": {
            "description": "Not Found",
            "content": {}
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors"
                }
              }
            }
          }
        },
        "security": [
          {
            "paylocity_auth": [
              "WebLinkAPI"
            ]
          }
        ],
        "x-codegen-request-body-name": "body"
      }
    }
  },
  "components": {
    "schemas": {
      "errors": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "Path": {
              "type": "string",
              "description": "Path where error occured."
            },
            "field": {
              "type": "string",
              "description": "The name of the field, or property in the request message that contains an error."
            },
            "message": {
              "type": "string",
              "description": "A message describing error."
            },
            "options": {
              "type": "array",
              "description": "A list of options associated with this error. These options may indicate valid values for the field, or property that contains an error.",
              "items": {
                "type": "object",
                "description": "An option associated with this error",
                "additionalProperties": false
              }
            }
          }
        }
      },
      "localTax": {
        "type": "object",
        "properties": {
          "exemptions": {
            "type": "number",
            "description": "Local tax exemptions value.<br  />Decimal (12,2)"
          },
          "exemptions2": {
            "type": "number",
            "description": "Local tax exemptions 2 value.<br  />Decimal (12,2)"
          },
          "filingStatus": {
            "type": "string",
            "description": "Employee local tax filing status. Must match specific local tax setup. <br  /> Max length: 50"
          },
          "residentPSD": {
            "type": "string",
            "description": "Resident PSD (political subdivision code) applicable in PA. Must match Company setup.<br  /> Max length: 9"
          },
          "taxCode": {
            "type": "string",
            "description": "Local tax code.<br  />Max length: 50"
          },
          "workPSD": {
            "type": "string",
            "description": "Work location PSD. Must match Company setup. <br  /> Max length: 9"
          }
        },
        "additionalProperties": false,
        "description": "The Local Tax model"
      }
    },
    "securitySchemes": {
      "paylocity_auth": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://api.paylocity.com/IdentityServer/connect/token",
            "scopes": {
              "WebLinkAPI": "Web Link Api"
            }
          }
        }
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```