---
title: "Create or update shopper address"
method: POST
path: "/v1/shoppers/me/addresses"
tags: ["Addresses"]
---

# Create or update shopper address

`POST /v1/shoppers/me/addresses`

Creates or updates a shopper's address.
An address entry must have a unique nickname.
If a current address has the same nickname specified in the request, that address is updated; otherwise, a new address is created.

## Query parameters

- `token` string
- `expand` string
- `fields` string

## Request body

- PostShopperAddressRequest
  - `address` object
    - `nickName` string — The nick name of the address.
    - `isDefault` string
    - `firstName` string — The shopper's first name.
    - `lastName` string
    - `companyName` string — Company Name
    - `line1` string — The first line of the address.
    - `line2` string — The second line of the address.
    - `line3` string — The third line of the address.
    - `city` string — City or town.
    - `countrySubdivision` string — State/County/Province/Region.
    - `postalCode` string — ZIP or postal code.
    - `country` string — A two-letter (ISO 3166-2) country code. See https://en.wikipedia.org/wiki/ISO_3166-2 for a complete list of country codes.
    - `countryName` string — Country.
    - `countyName` string — County.
    - `phoneNumber` string — The shopper's phone number.
    - `phoneticFirstName` string — The shopper's Japanese Katakana first name. (Optional, usually for Japanese locale.)
    - `phoneticLastName` string — The shopper's Japanese Katakana last name. (Optional, usually for Japanese locale.)
    - `division` string — The shopper's company departmant name. (Optional, usually for Japanese locale.)

## Response `204`

No Content

## Other responses

- `401` — * Invalid Token
- `409` — * invalid-state-code * invalid-postal-code

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-shopper-apis/revisions/4b69392f93b9/schema)