Update a work location's details

Update a work location's address or name with this endpoint.

Call this endpoint to update the core details of a work location, like its address. This is typically useful when an address was initially created with incorrect details and needs to be corrected later, but there can be critical compliance consequences to paying payroll with incorrect addresses, so you should read and understand all this documentation before using this endpoint. Be aware.


⚠️

Validate your addresses before creating work locations

The address of a work location is used for critical compliance workflows in Everee, like allocating tax liability accurately to the right state and locality, or determining the correct time-off policy rules to apply to hours worked.

When wage items, like timesheet hours and payable items, are paid out, these compliance areas are processed according to the work location's address. If that address was incorrect, taxes may calculate incorrectly and be paid to the wrong jurisdiction, which is a critical compliance error.

It's extremely important to validate work location addresses (ideally visually, on a map) before creating work locations to use in payroll. These kinds of compliance errors cause significant effort and liability concerns, and should be avoided.


Changing an address doesn't trigger automatic corrections

When an address is changed for a work location that's already been used to pay payroll to employees, that could mean that taxes have already been calculated incorrectly and paid to the wrong jurisdiction (see warning above).

If that's happened, and you change the address, there may be compliance consequences. You may need to amend tax filings, pay additional taxes or penalties, and correct employees' net pay if their wages were withheld incorrectly.

We don't assume anything about the downstream consequences of changing a work location's address, so if you change an address, we won't automatically trigger wage corrections, amended tax filings, or anything else.

If the work location has already been used to pay payroll, you can change its address, but the new address will only apply to upcoming payroll. We won't change anything retroactively, so even though the address is correct going forward, you may still be liable for consequences on past payroll.

Path Params
string
required

The ID of the work location to update.

Body Params
string

Human-readable name. Should not include UUIDs or similar "system data", since it will be printed on pay stubs. See the "externalId" field for custom IDs.

string

First line of the street address. Typically used for street number and name.

string

Second line of the street address. Typically used for building, floor, suite, room, or similar designators.

string

City name of the street address.

string

State code of the street address. 2-letter state abbreviation, e.g. "CA".

string

Postal code of the street address. 5-digit numeric string ZIP code, e.g. "90210".

string

10-digit numeric string phone number, e.g. "4152992020"

double

Latitude coordinate. If not provided, Everee will automatically determine it based on the other address fields, and return an error if we can't.

double

Longitude coordinate. If not provided, Everee will automatically determine it based on the other address fields, and return an error if we can't.

Response

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json