Add or change an address

post

https://apis.kentro.live/store/v1/addresses.save

Adds an address (no id; an optional createId of your own makes the add idempotent) or changes one (id with its expectedVersion). isDefault: true makes it the default. type is shipping, billing, mailing or general.

Who may call it: A signed-in buyer (X-Storefront-Buyer); without one the answer is 401 UNAUTHORIZED.

Body Params

uuid

createId

uuid

expectedVersion

string

^[a-f0-9]{64}$

label

string

required

length ≤ 100

name

string

required

length between 1 and 255

company

string

required

length ≤ 255

line1

string

required

length between 1 and 255

line2

string

required

length ≤ 255

city

string

required

length between 1 and 255

region

string

required

length ≤ 100

postalCode

string

required

length between 1 and 30

country

string

required

^[A-Z]{2}$

phone

string

required

length ≤ 100

isDefault

boolean

required

type

enum

unitSuit

string

length ≤ 100

enum

vatId

string

length ≤ 100

note

string

carrierId

geoLocation

object | null

Headers

X-Storefront-Host

string

required

length between 1 and 253

The published storefront host the request serves (shop.example.com, lower case). It must belong to the tenant of the API key; 404 NOT_FOUND when no published storefront answers it, 403 FORBIDDEN when it belongs to another account.

X-Storefront-Buyer

string

The signed-in buyer's access token (accessToken from POST https://apis.kentro.live/auth/login/customer). Absent for a guest or an anonymous visitor.

X-Storefront-Guest

string

The guest token session.guest answered, which identifies a guest cart and a guest checkout. Send it along with X-Storefront-Buyer at sign-in so the buyer can choose between the guest cart and the account cart.

X-Storefront-Client-Ip

string

The end buyer's IP address as your storefront server saw it. Used for per-visitor limits (search typeahead, sign-up); without it the limits apply to your server.

X-Expected-Portal

string

The store id (store.get answers id) your page was rendered for. When the host now resolves to another store the answer is 409 CONFLICT, so a stale page never acts on the wrong store.

X-Expected-Buyer

string

The identity your page was rendered for: the buyer id, guest:<guestId> for a guest, or guest for an anonymous visitor. A mismatch with the tokens sent is 409 CONFLICT, so a stale page never acts for the wrong buyer.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The address book after the change.

defaultThe request was refused or could not be completed; the status says why (400 validation, 401 sign-in needed, 403 not allowed, 404 unknown, 409 stale revision or version, 422 commerce rule, 429 too many, 503 unavailable).