/api/v1/address/update

Updates an existing address identified by ID. Only provided fields will be updated, omitted fields remain unchanged. Address is automatically validated and normalized. Requires identityId to verify the address belongs to the contact.

AddresspostApiV1AddressUpdate

Parameters

1 query · 15 body

16 total

Query · 1

apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

Body · 15

identityIdstringRequired

Logged user identity (from your frontend cookies). Learn more

idstringRequired

Address external identifier (core__address.external_id).

typestring

Address type code. Common values: delivery, billing, contact, invoice.

firstNamestring

First name of the person.

lastNamestring

Last name of the person.

companyNamestring

Company name (for business addresses).

streetAddressstring

Street name and house number.

postalCodestring

Postal/ZIP code.

citystring

City name.

cityPartstring

City district or part.

stateRegionstring

State or region name.

countrystring

ISO 3166-1 alpha-2 country code.

companyRegistrationNumberstring

Company registration number (IČO in CZ).

taxIdentificationNumberstring

Tax identification number (DIČ in CZ, VAT ID in EU).

noticestring

Additional notes or delivery instructions.

Request

POST /api/v1/address/update

post

curl -X POST "https://api.bizkithub.com/api/v1/address/update?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "identityId": "Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg",
  "id": "6IU2SWgP76FO2UXw",
  "type": "delivery",
  "firstName": "example_firstName",
  "lastName": "example_lastName",
  "companyName": "example_companyName",
  "streetAddress": "example_streetAddress",
  "postalCode": "example_postalCode",
  "city": "example_city",
  "cityPart": "example_cityPart",
  "stateRegion": "example_stateRegion",
  "country": "CZ",
  "companyRegistrationNumber": "example_companyRegistrationNumber",
  "taxIdentificationNumber": "example_taxIdentificationNumber",
  "notice": "example_notice"
}'

Response

JSON payload

{
  "id": "6IU2SWgP76FO2UXw",
  "type": "delivery",
  "firstName": "example_firstName",
  "lastName": "example_lastName",
  "companyName": "example_companyName",
  "companyRegistrationNumber": "example_companyRegistrationNumber",
  "taxIdentificationNumber": "example_taxIdentificationNumber",
  "streetAddress": "example_streetAddress",
  "city": "example_city",
  "cityPart": "example_cityPart",
  "stateRegion": "example_stateRegion",
  "postalCode": "example_postalCode",
  "country": "CZ",
  "notice": "example_notice"
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key