/api/v1/address/create

Creates a new address for the specified contact. Address is automatically validated and normalized (street names, postal codes, etc.). If country is not provided, it defaults to the organisation default country. Returns the created address object with the generated ID.

AddresspostApiV1AddressCreate

Parameters

1 query · 14 body

15 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 · 14

identityIdstringRequired

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

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/create

post

curl -X POST "https://api.bizkithub.com/api/v1/address/create?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "identityId": "Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg",
  "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