---
title: "Update an address"
method: PUT
path: "/v2/addresses/{address_id}"
tags: ["Address Book"]
---

# Update an address

`PUT /v2/addresses/{address_id}`

Updates values in an existing address

## Path parameters

- `address_id` string, required

## Request body

- AddressRequest
  - `name` string, required — The name of the addressee
  - `organization` string, nullable — The organization of the addressee
  - `email` string, email, nullable — The email of the addressee
  - `phone` string, nullable — The phone number of the addressee
  - `address_line_1` string, required — The first line of the address
  - `address_line_2` string, nullable — The second line of the address. Must be percent encoded when passed as a query parameter (e.g. `#200` → `%23200`).
  - `city_locality` string, nullable — The city or locality of the address
  - `state_province` string, nullable — The state, province, county, or municipal division
  - `postal_code` string, nullable — The postal code or zip code
  - `country_code` string, required — The ISO 3166 country code
  - `address_type` 'unknown' | 'residential' | 'commercial' | 'po_box' | 'military' — The residential/commercial type of the address from the delivery/pickup standpoint `unknown` At the moment it is not possible to establish if the address is of any known type `residential` The address is a residence `commercial` The address is associated with a business `po_box` The address is a PO Box `military` The address is a military address

## Response `204`

Successful Response

## Other responses

- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/goshippo/apis/shippo-address-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-address-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-address-api/revisions/26fcc6af452a/schema)