---
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`

## Request

- Base URL: `https://api.digitalriver.com`
- URL: `https://api.digitalriver.com/v1/shoppers/me/addresses`
- Auth: none declared

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.dev/digitalriver/apis/commerce-api-suite-shopper-apis.md) - [All operations](https://skmtc.dev/digitalriver/apis/commerce-api-suite-shopper-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/digitalriver/apis/commerce-api-suite-shopper-apis/revisions/4b69392f93b9?raw)