---
title: "Update an employee's home address"
method: PUT
path: "/v1/home_addresses/{home_address_uuid}"
tags: ["Employee Addresses"]
---

# Update an employee's home address

`PUT /v1/home_addresses/{home_address_uuid}`

The home address of an employee is used to determine certain tax information about them. Addresses are geocoded on create and update to ensure validity.

Supports home address effective dating and courtesy withholding.

scope: `employees:write`

## Path parameters

- `home_address_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- object
  - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `street_1` string
  - `street_2` string, nullable
  - `city` string
  - `state` string
  - `zip` string
  - `effective_date` string, date, nullable
  - `courtesy_withholding` boolean

## Response `200`

successful

- EmployeeAddress
  - `uuid` string, required — The UUID of the employee address
  - `employee_uuid` string — The UUID of the employee
  - `effective_date` string, date — The date the employee started living at the address.
  - `courtesy_withholding` boolean — Determines if home taxes should be withheld and paid for employee.
  - `street_1` string
  - `street_2` string, nullable
  - `city` string
  - `state` string
  - `zip` string
  - `country` string
  - `active` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.
  - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)