Sign in
Address Book

Update Address

Modify the details of an existing address record in the system's address book. With this endpoint, you can submit updated information for a specific address, ensuring that it reflects the most current and accurate data.

put/v4/addresses/{addressId}

Path parameters

addressIdstring required

A unique identifier for each existing address record stored in the address book. This information ensures that each address can be distinctly referenced and managed within the system.

Request body

ContactNamestring nullable

The name of the primary contact associated with the address. This field is essential for identification and communication purposes.

CompanyNamestring nullable

The name of the company linked to the address. This field provides context for the address, especially in business-related queries.

ContactEmailstring email nullable

The email address of the primary contact for the address. This is used for correspondence and can facilitate communication directly related to the address.

ContactPhonestring tel nullable

The phone number of the primary contact associated with the address. This field is crucial for any immediate communication needs.

Line1string required

The first line of the address, typically containing the primary address information such as house number and street name.

Line2string nullable

An optional second line for the address, often used for additional details like apartment numbers or suite designations.

Line3string nullable

A third optional line in the address to include any further address specifications, allowing for more detailed address information if necessary.

Townstring required

The town or city, indicating the specific locality where the address is located.

Postcodestring nullable

The postal or ZIP code corresponding to the address, used to identify specific geographic areas.

Countystring nullable

The county, state, or province in which the address is located, providing additional geographical context for the address.

CountryCodestring required

An abbreviation representing the country of the address, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.

What3Wordsstring nullable

A three-word location identifier provided by the What3words service, offering a precise way to define addresses using a unique combination of three words, for example, the front door of 10 Downing Street in London is identified by slurs.this.shark.

Example request

{
  "ContactName": "Jane Doe",
  "CompanyName": "My Company Ltd.",
  "ContactEmail": "jane@example.com",
  "Line1": "10 Sky Lane",
  "CountryCode": "GB",
  "What3Words": "brick.space.employ"
}

Response

The address book was updated successfully.

Changes

No recorded changes to this endpoint across all 1 revision of this API.