# Create contact

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

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

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `businessName` (string)
    Registered or trading name if the contact is a business.

  - `code` (string)
    Practice-specific human-readable contact code.

  - `contactDetails` (array, required)
    List of contact details such as phone numbers and email addresses.

  - `contactDetails.contactDetailId` (string, required)
    Canonical identifier for this contact detail.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactDetails.contactDetailType` (object, required)
    Coded type of the contact detail (e.g. phone, email).

  - `contactDetails.contactDetailType.code` (string, required)
    Code value

  - `contactDetails.contactDetailType.system` (string, required)
    Code system URI

  - `contactDetails.contactDetailType.display` (string)
    Human-readable display

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

  - `contactDetails.createdAt` (string, required)
    Timestamp when this contact detail was created.
    Example: "2025-01-01T00:00:00.000Z"

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

  - `contactDetails.isActive` (boolean)
    Whether this contact detail is currently active.

  - `contactDetails.isPreferred` (boolean)
    Whether this is the preferred contact detail of its type for the contact.

  - `contactDetails.name` (string, required)
    Label or type name for the contact detail (e.g. 'Home phone', 'Email').

  - `contactDetails.subscriptionGroups` (array)
    Identifiers of communication subscription groups associated with this contact detail.

  - `contactDetails.updatedAt` (string, required)
    Timestamp when this contact detail was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `contactDetails.value` (string, required)
    Raw value of the contact detail (e.g. phone number, email address).

  - `contactDetails.valueCleaned` (string,null)
    System-normalized representation of the value, if available.

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

  - `creditStatus` (string)
    Credit status for the contact.
    Enum: "OK", "WARNING", "STOP"

  - `birthDate` (string)
    Date of birth of the contact, if applicable.
    Example: "2025-01-01"

  - `driverLicenseExpiryDate` (string)
    Expiry date of the driver license.
    Example: "2025-01-01"

  - `driverLicenseIssuer` (string)
    Issuing authority or jurisdiction for the driver license.

  - `driverLicenseNumber` (string)
    Driver license number, if captured.

  - `firstName` (string, required)
    Given name of the contact.

  - `isBusiness` (boolean)
    True if the contact represents a business entity.

  - `isCustomer` (boolean)
    True if the contact is a customer.

  - `isStaffMember` (boolean)
    True if the contact is a staff member of the practice.

  - `isSupplier` (boolean)
    True if the contact is a supplier.

  - `isSyndicate` (boolean)
    True if the contact is a syndicate or group owner.

  - `isVet` (boolean)
    True if the contact is a veterinarian.

  - `lastName` (string, required)
    Family name of the contact.

  - `ownershipId` (string)
    Identifier for the owning organization or business unit.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `physicalAddress` (string)
    Primary physical address for the contact.

  - `postalAddress` (string)
    Primary postal/mailing address for the contact.

  - `creditStatusConcept` (object)
    Coded representation of the contact's credit status using an extensible vocabulary.

## Response 201 fields (application/json):

  - `businessName` (string, required)
    Registered or trading name if the contact is a business.

  - `code` (string, required)
    Practice-specific human-readable contact code.

  - `contactDetails` (array, required)
    List of contact details such as phone numbers and email addresses.

  - `contactDetails.contactDetailId` (string, required)
    Canonical identifier for this contact detail.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactDetails.contactDetailType` (object, required)
    Coded type of the contact detail (e.g. phone, email).

  - `contactDetails.contactDetailType.code` (string, required)
    Code value

  - `contactDetails.contactDetailType.system` (string, required)
    Code system URI

  - `contactDetails.contactDetailType.display` (string)
    Human-readable display

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

  - `contactDetails.createdAt` (string, required)
    Timestamp when this contact detail was created.
    Example: "2025-01-01T00:00:00.000Z"

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

  - `contactDetails.isActive` (boolean)
    Whether this contact detail is currently active.

  - `contactDetails.isPreferred` (boolean)
    Whether this is the preferred contact detail of its type for the contact.

  - `contactDetails.name` (string, required)
    Label or type name for the contact detail (e.g. 'Home phone', 'Email').

  - `contactDetails.subscriptionGroups` (array)
    Identifiers of communication subscription groups associated with this contact detail.

  - `contactDetails.updatedAt` (string, required)
    Timestamp when this contact detail was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `contactDetails.value` (string, required)
    Raw value of the contact detail (e.g. phone number, email address).

  - `contactDetails.valueCleaned` (string,null)
    System-normalized representation of the value, if available.

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

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

  - `creditStatus` (string, required)
    Credit status for the contact.
    Enum: "OK", "WARNING", "STOP"

  - `birthDate` (string, required)
    Date of birth of the contact, if applicable.
    Example: "2025-01-01T00:00:00Z"

  - `driverLicenseExpiryDate` (string, required)
    Expiry date of the driver license.
    Example: "2025-01-01T00:00:00Z"

  - `driverLicenseIssuer` (string, required)
    Issuing authority or jurisdiction for the driver license.

  - `driverLicenseNumber` (string, required)
    Driver license number, if captured.

  - `firstName` (string, required)
    Given name of the contact.

  - `isBusiness` (boolean, required)
    True if the contact represents a business entity.

  - `isCustomer` (boolean, required)
    True if the contact is a customer.

  - `isStaffMember` (boolean, required)
    True if the contact is a staff member of the practice.

  - `isSupplier` (boolean, required)
    True if the contact is a supplier.

  - `isSyndicate` (boolean, required)
    True if the contact is a syndicate or group owner.

  - `isVet` (boolean, required)
    True if the contact is a veterinarian.

  - `lastName` (string, required)
    Family name of the contact.

  - `ownershipId` (string, required)
    Identifier for the owning organization or business unit.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `physicalAddress` (string, required)
    Primary physical address for the contact.

  - `postalAddress` (string, required)
    Primary postal/mailing address for the contact.

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

  - `creditStatusConcept` (object, required)
    Coded representation of the contact's credit status using an extensible vocabulary.


## Response 400 fields

## Response 401 fields

## Response 409 fields