Skip to main content
PATCH
Update Address

Authorizations

x-revolv3-token
string
header
required

Headers

Client-Request-Id
string

Optional identifier generated by the client to match its own logs with this request.

Allowed values: 1 to 128 characters, letters, digits and ., _, :, -.

Examples: order-12345, 3f2b8c1e-9d4a-4e7b-a1c5-6b0d2e8f7a91 (GUID), checkout:2026-11-02.17, retry_1.order-12345.

A valid value is returned in the Client-Request-Id response header and is stored with Revolv3 request logs, so it can be used when contacting support. An invalid value is ignored and the request is processed normally. Do not send sensitive data in this header.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]{1,128}$

Path Parameters

customerId
integer<int64>
required
Required range: 1 <= x <= 1000000000
addressId
integer<int64>
required
Required range: 1 <= x <= 1000000000

Body

addressLine1
string | null

Address.

Maximum string length: 3000
addressLine2
string | null

Supplemental information for the address.

Maximum string length: 3000
city
string | null

City.

Maximum string length: 3000
state
string | null

State.

Maximum string length: 2
postalCode
string | null

Postal Code.

Required string length: 2 - 20
phoneNumber
string | null

The phone number associated with a payment method that is used for billing purposes.

Required string length: 7 - 21
Pattern: ^(?=.*\d)\+?[0-9\s\-\(\)\.]{7,20}$
email
string<email> | null

The email associated with a billing address.

Maximum string length: 3000
country
string | null

The input must be a valid Alpha2 code, Alpha3 code, UN code, or full country name.

Maximum string length: 2

Response

OK

customerId
integer<int64>
Required range: 1 <= x <= 1000000000
merchantCustomerRefId
string | null
Maximum string length: 100
firstName
string | null
Maximum string length: 150
lastName
string | null
Maximum string length: 150
billingAddresses
object[] | null
shippingAddresses
object[] | null
taxAddresses
object[] | null
subscriptions
object[] | null