Work Locations

Before onboarding a W-2 Employee, we'll need to specify where the employee will be working. This is known as a Work Location and is important for taxation purposes. A Work Location is often reused for multiple employees but may also only be used by one employee (often the case for remote employees).

📝

Note

Work Locations aren't required to onboard 1099 Contractors due to their taxable status. To learn how to onboard contractors, reference our Contractor Onboarding Guide.

API

1. Call Resolve Taxable Location to verify that an address is taxable.

🔔

Note

Remember to replace the placeholders such as {{testApiKey}} in the code samples below.

curl --request POST \
     --url https://api.zeal.com/taxableLocations \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{testApiKey}}' \
     --header 'Content-Type: application/json' \
     --data '
{
    "street1": "941 Newell Rd.",
    "street2": "",
    "city": "Palo Alto",
    "state": "CA",
    "zip": "94303"
}
'

2. Include the taxableLocationID returned along with the companyID of the Company to call Create Work Location.

curl --request POST \
     --url https://api.zeal.com/workLocations \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{testApiKey}}' \
     --header 'Content-Type: application/json' \
     --data '
{
     "taxableLocationID": "{{taxableLocationID}}",
     "companyID": "{{companyID}}",
     "name": "Main Office"
}
'

Congrats!
You've created your first Work Location! You can call Get Work Locations to see the results.

White-Label

1. Navigate to your Partner Dashboard and ensure that Test Mode is enabled.
2. Click on a company to access the Employer Dashboard as an Admin.

3. Click on the Work Locations page, then click Add New Location.

4. On the Work Location page fill the form that appears with a taxable address, then click Create.

Congrats!
You've created your first Work Location! You should now see it listed in the dashboard.