# Create external hotlink

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

Endpoint: POST /site/{siteId}/ahds/v1/external-hotlink
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `description` (string)
    Human-readable description or label for the hotlink.

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

  - `externalHotlinkId` (string, required)
    Canonical identifier for this external hotlink.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resourceId` (string, required)
    Identifier of the resource this hotlink is associated with.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resourceType` (string, required)
    Type of resource this hotlink is associated with (e.g., animal, contact, invoice).

  - `status` (string)
    Lifecycle status of the external hotlink.
    Enum: "active", "inactive"

  - `url` (string, required)
    Target URL of the external hotlink.

## Response 201 fields (application/json):

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

  - `description` (string, required)
    Human-readable description or label for the hotlink.

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

  - `externalHotlinkId` (string, required)
    Canonical identifier for this external hotlink.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resourceId` (string, required)
    Identifier of the resource this hotlink is associated with.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `resourceType` (string, required)
    Type of resource this hotlink is associated with (e.g., animal, contact, invoice).

  - `status` (string, required)
    Lifecycle status of the external hotlink.
    Enum: "active", "inactive"

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

  - `url` (string, required)
    Target URL of the external hotlink.


## Response 400 fields

## Response 401 fields

## Response 409 fields