v1

latestOpenAPI 3.0.12026-07-242073551.1 MB
Address Book

Update Address Book

Updates a shipping address from your address book

put/v4/addresses/{addressId}

Path parameters

addressIdstring required

Address Identifier <br />SAPIENT AddressId (assigned by SAPIENT or by you).

Request body

ContactNamestring nullable

Contact Name <br />The contact name or company name is required. <br />Up to 50 characters may be allowed.However it is carrier dependent. Some carriers may allow less.

CompanyNamestring nullable

Company Name <br />The contact name or company name is required. <br />Up to 50 characters may be allowed.However it is carrier dependent. Some carriers may allow less.

ContactEmailstring email nullable

Contact Phone Number

ContactPhonestring tel nullable

Contact Phone Number

Line1string required

Address Line 1 <br />Up to 50 characters may be allowed, however it is carrier dependent and some carriers may allow less.

Line2string nullable

Address Line 2 <br />Up to 50 characters may be allowed, however it is carrier dependent and some carriers may allow less.

Line3string nullable

Address Line 3 <br />Up to 50 characters may be allowed, however it is carrier dependent and some carriers may allow less.

Townstring required

Town <br />Up to 50 characters may be allowed, however it is carrier dependent and some carriers may allow less.

Postcodestring nullable

Postcode / Zip <br />Required for United Kingdom addresses and some international addresses. <br />The Countries API can be used to check whether postcode/zip code is required for a country. <br />Up to 20 characters may be allowed, however it is carrier dependent and some carriers may allow less.

Countystring nullable

County / State / Province <br />May be required depending on the country. <br />For USA, Australia and Canada, if provided, must be a valid state code or name. <br />The Countries API can be used to check whether county/state is required for a country. <br />Up to 50 characters may be allowed, however it is carrier dependent and some carriers may allow less.

CountryCodestring required

Country Code <br />2 Digit ISO Country Code, per ISO 3166 Standard.

What3Wordsstring nullable

The what3words identifier for this address.

Example request

{
  "ContactName": "Jane Doe",
  "CompanyName": "My Company Ltd.",
  "ContactEmail": "jane@example.com",
  "ContactPhone": "07123887422",
  "Line1": "10 Sky Lane",
  "Line2": "123 Main Street",
  "Line3": "Hills End",
  "Town": "Christchurch",
  "Postcode": "TW20 0HJ",
  "County": "Surrey",
  "CountryCode": "GB",
  "What3Words": "brick.space.employ"
}

Response

The address book was updated successfully.