# Create address

Creates a new Address record. Address resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/address
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `addressId` (string, required)
    Canonical unique identifier for the address.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `city` (string)
    City, town, or locality.

  - `contactId` (string, required)
    Identifier of the contact this address belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `countryCode` (string)
    ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.

  - `distance` (object)
    Optional distance from a reference point, when returned by search operations.

  - `distance.value` (number, required)
    Numeric value

  - `distance.unit` (string, required)
    Unit of measure

  - `distance.system` (string)
    Unit system URI

  - `extensions` (object)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether the address is currently active/usable.

  - `latitude` (number)
    Latitude in decimal degrees (WGS84).

  - `line1` (string)
    First line of the street address.

  - `line2` (string)
    Second line of the street address.

  - `longitude` (number)
    Longitude in decimal degrees (WGS84).

  - `name` (string)
    Optional label or name for the address (e.g., 'Home', 'Work').

  - `postalCode` (string)
    Postal or ZIP code.

  - `region` (string)
    Region, province, or county.

  - `state` (string)
    State or territory (where applicable).

  - `suburb` (string)
    Suburb, neighborhood, or village.

  - `country` (object, required)
    Country represented as a coded concept, allowing explicit system and display text.

  - `country.code` (string, required)
    Code value

  - `country.system` (string, required)
    Code system URI

  - `country.display` (string)
    Human-readable display

## Response 201 fields (application/json):

  - `addressId` (string, required)
    Canonical unique identifier for the address.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `city` (string, required)
    City, town, or locality.

  - `contactId` (string, required)
    Identifier of the contact this address belongs to.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `countryCode` (string, required)
    ISO 3166-1 alpha-2 country code when available; otherwise a system-specific country identifier.

  - `createdAt` (string, required)
    Timestamp when the address was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `distance` (object, required)
    Optional distance from a reference point, when returned by search operations.

  - `distance.value` (number, required)
    Numeric value

  - `distance.unit` (string, required)
    Unit of measure

  - `distance.system` (string)
    Unit system URI

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Whether the address is currently active/usable.

  - `latitude` (number, required)
    Latitude in decimal degrees (WGS84).

  - `line1` (string, required)
    First line of the street address.

  - `line2` (string, required)
    Second line of the street address.

  - `longitude` (number, required)
    Longitude in decimal degrees (WGS84).

  - `name` (string, required)
    Optional label or name for the address (e.g., 'Home', 'Work').

  - `postalCode` (string, required)
    Postal or ZIP code.

  - `region` (string, required)
    Region, province, or county.

  - `state` (string, required)
    State or territory (where applicable).

  - `suburb` (string, required)
    Suburb, neighborhood, or village.

  - `updatedAt` (string, required)
    Timestamp when the address was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `country` (object, required)
    Country represented as a coded concept, allowing explicit system and display text.

  - `country.code` (string, required)
    Code value

  - `country.system` (string, required)
    Code system URI

  - `country.display` (string)
    Human-readable display


## Response 400 fields

## Response 401 fields

## Response 409 fields