# Create webhook endpoint

Create a new webhook endpoint to receive event notifications. Specify the URL and the event types you want to subscribe to. A signing secret will be generated and returned - store it securely.

Endpoint: POST /partner/v2/webhook
Version: 2.0
Security: PartnerOAuth

## Request fields (application/json):

  - `eventTypes` (array, required)
    Event types to subscribe to
    Example: ["appointment.created","appointment.updated","form.completed"]

  - `name` (string)
    Friendly name for the endpoint
    Example: "Production Webhook"

  - `secretToken` (string)
    Secret token for additional verification (sent in X-Webhook-Token header)

  - `url` (string, required)
    Webhook URL (must be HTTPS)
    Example: "https://api.example.com/webhooks/lobbie"

## Response 201 fields (application/json):

  - `createdAt` (string)
    Creation timestamp
    Example: "2025-01-01T10:00:00Z"

  - `eventTypes` (array)
    Event types this endpoint is subscribed to
    Example: ["appointment.created","appointment.updated","form.completed"]

  - `failureCount24h` (integer)
    Number of failed deliveries in the last 24 hours
    Example: 2

  - `id` (integer)
    Unique webhook endpoint identifier
    Example: 12345

  - `isEnabled` (boolean)
    Whether this endpoint is enabled
    Example: true

  - `lastFailureAt` (string)
    Timestamp of last failed delivery

  - `lastSuccessAt` (string)
    Timestamp of last successful delivery

  - `name` (string)
    Friendly name for the endpoint
    Example: "Production Webhook"

  - `signingSecret` (string)
    Signing secret (only shown on creation)
    Example: "whsec_abc123..."

  - `successCount24h` (integer)
    Number of successful deliveries in the last 24 hours
    Example: 42

  - `updatedAt` (string)
    Last update timestamp
    Example: "2025-01-10T14:30:00Z"

  - `url` (string)
    Webhook URL where events are delivered
    Example: "https://api.example.com/webhooks/lobbie"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 422 fields