# Create a new webhook subscription

Creates a new webhook subscription for receiving near‑real‑time event notifications.

Features:
- Validates the callback URL format; only HTTPS is supported
- Sets an automatic expiration date of 15 days for subscriptions
- Only one subscription per event type is allowed per partner/operator; returns 409 if a non-deleted subscription for the same event type already exists

For more information on setting up and managing webhooks, see the Event Notifications (Webhook) Guide.

Endpoint: POST /api/v2/webhooks/subscriptions
Version: 2.6.0
Security: X-Api-Client-Id, X-Auth-Token

## Request fields (application/json):

  - `event` (string, required)
    Enum: "FLIGHT_CREATE", "FLIGHT_CANCEL", "FLIGHT_TIME_UPDATE", "FLIGHT_AIRCRAFT_UPDATE", "FLIGHT_AIRPORT_UPDATE", "FLIGHT_POST_FLIGHT_STATUS", "FLIGHT_MOVEMENT_UPDATE", "FLIGHT_PAX_COUNT_UPDATE", "FLIGHT_PAX_LIST_UPDATE", "FLIGHT_PERMIT_ASSIGNMENT", "FLIGHT_PERMIT_UNASSIGNMENT", "FLIGHT_SLOT_PPR_ASSIGNMENT", "FLIGHT_SLOT_PPR_UNASSIGNMENT", "FLIGHT_FBO_ASSIGNMENT", "FLIGHT_FBO_UNASSIGNMENT", "FLIGHT_HOTEL_ASSIGNMENT", "FLIGHT_HOTEL_UNASSIGNMENT", "FLIGHT_CATERING_ASSIGNMENT", "FLIGHT_CATERING_UNASSIGNMENT", "FLIGHT_TRANSPORT_ASSIGNMENT", "FLIGHT_TRANSPORT_UNASSIGNMENT", "FLIGHT_CREW_ASSIGNMENT", "FLIGHT_CREW_DOCUMENT_UPDATE", "FLIGHT_CREW_ADDRESS_UPDATE"

  - `callbackUrl` (string, required)
    Example: "https://example.com/webhooks/flight-updates"

  - `signingKey` (string, required)
    Example: "your-secret-signing-key-123"

## Response 201 fields (application/json):

  - `id` (string)
    Example: "webhook-sub-12345"

  - `event` (string)
    Enum: "FLIGHT_CREATE", "FLIGHT_CANCEL", "FLIGHT_TIME_UPDATE", "FLIGHT_AIRCRAFT_UPDATE", "FLIGHT_AIRPORT_UPDATE", "FLIGHT_POST_FLIGHT_STATUS", "FLIGHT_MOVEMENT_UPDATE", "FLIGHT_PAX_COUNT_UPDATE", "FLIGHT_PAX_LIST_UPDATE", "FLIGHT_PERMIT_ASSIGNMENT", "FLIGHT_PERMIT_UNASSIGNMENT", "FLIGHT_SLOT_PPR_ASSIGNMENT", "FLIGHT_SLOT_PPR_UNASSIGNMENT", "FLIGHT_FBO_ASSIGNMENT", "FLIGHT_FBO_UNASSIGNMENT", "FLIGHT_HOTEL_ASSIGNMENT", "FLIGHT_HOTEL_UNASSIGNMENT", "FLIGHT_CATERING_ASSIGNMENT", "FLIGHT_CATERING_UNASSIGNMENT", "FLIGHT_TRANSPORT_ASSIGNMENT", "FLIGHT_TRANSPORT_UNASSIGNMENT", "FLIGHT_CREW_ASSIGNMENT", "FLIGHT_CREW_DOCUMENT_UPDATE", "FLIGHT_CREW_ADDRESS_UPDATE"

  - `callbackUrl` (string)
    Example: "https://example.com/webhooks"

  - `status` (string)
    Enum: "ACTIVE", "INACTIVE"

  - `createdAtDateTime` (string)
    Example: "2024-01-15T10:30:00.000Z"

  - `updatedAtDateTime` (string)
    Example: "2024-01-15T10:30:00.000Z"

  - `expirationDateTime` (string)
    Example: "2024-02-15T10:30:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 409 fields

## Response 500 fields