# Create webhook

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

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

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `eventType` (string, required)
    Type of event that triggers this webhook.

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

  - `fields` (array)
    Optional list of field names to include in the webhook payload. If omitted or empty, the default payload for the event type is sent.

  - `isActive` (boolean, required)
    Whether the webhook is currently active and will receive events.

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

  - `webhookUrl` (string, required)
    Destination URL that will receive webhook POST requests.

  - `description` (string)
    Human-readable description of the webhook's purpose or usage, intended to help administrators understand what this webhook is for.

## Response 201 fields (application/json):

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

  - `eventType` (string, required)
    Type of event that triggers this webhook.

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

  - `fields` (array, required)
    Optional list of field names to include in the webhook payload. If omitted or empty, the default payload for the event type is sent.

  - `isActive` (boolean, required)
    Whether the webhook is currently active and will receive events.

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

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

  - `webhookUrl` (string, required)
    Destination URL that will receive webhook POST requests.

  - `description` (string, required)
    Human-readable description of the webhook's purpose or usage, intended to help administrators understand what this webhook is for.


## Response 400 fields

## Response 401 fields

## Response 409 fields