# Create webhook event

Creates a new Webhook Event record. Canonical representation of a webhook event configuration or capability.

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

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `description` (string)
    Human-readable description of the webhook event.

  - `eventType` (string, required)
    Type of event that will trigger the webhook.
    Enum: "appointment.created", "appointment.updated", "product.created", "product.updated", "user.created", "user.updated", "consult.created", "consult.updated", "therapeutic.created", "therapeutic.updated", "therapeutic.disabled", "defaultBillingTrigger.created", "defaultBillingTrigger.updated", "defaultBillingTrigger.disabled", "bundle.created", "bundle.updated", "bundle.disabled"

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

  - `isEnabled` (boolean, required)
    Whether this webhook event is currently enabled.

  - `webhookEventId` (string, required)
    Stable, opaque identifier for this webhook event configuration.
    Example: "123e4567-e89b-12d3-a456-426614174000"

## Response 201 fields (application/json):

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

  - `description` (string, required)
    Human-readable description of the webhook event.

  - `eventType` (string, required)
    Type of event that will trigger the webhook.
    Enum: "appointment.created", "appointment.updated", "product.created", "product.updated", "user.created", "user.updated", "consult.created", "consult.updated", "therapeutic.created", "therapeutic.updated", "therapeutic.disabled", "defaultBillingTrigger.created", "defaultBillingTrigger.updated", "defaultBillingTrigger.disabled", "bundle.created", "bundle.updated", "bundle.disabled"

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

  - `isEnabled` (boolean, required)
    Whether this webhook event is currently enabled.

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

  - `webhookEventId` (string, required)
    Stable, opaque identifier for this webhook event configuration.
    Example: "123e4567-e89b-12d3-a456-426614174000"


## Response 400 fields

## Response 401 fields

## Response 409 fields