# Create Webhook Subscription

Create a new webhook subscription to receive event notifications at the specified URL.

Endpoint: POST /v1/webhook-subscriptions
Security: OAuth2

## Request fields (application/json):

  - `url` (string, required)
    The URL to send webhook events to.

  - `event_types` (array, required)
    List of event types to subscribe to.
At least one event type must be specified.

  - `state` (string, required)
    The state of the subscription.
    Enum: "ENABLED", "DISABLED"

  - `description` (string)
    A description of the subscription.

  - `metadata` (object)
    Additional metadata for the subscription.

This property lets you add custom data to the subscription.
The key has a limit of 40 characters and the value has a limit of 500 characters.

## Response 201 fields (application/json):

  - `id` (string, required)
    The unique identifier of the subscription.

  - `url` (string, required)
    The URL to send webhook events to.

  - `event_types` (array, required)
    List of event types this subscription is subscribed to.

  - `state` (string, required)
    The state of the subscription.
    Enum: "ENABLED", "DISABLED"

  - `created_at` (string, required)
    Timestamp of when the subscription was created.

  - `updated_at` (string, required)
    Timestamp of when the subscription was last updated.

  - `secret` (string, required)
    The secret key for verifying webhook signatures.

This value is only returned once when the subscription is created.
Store it securely as it cannot be retrieved again.

  - `description` (string)
    A description of the subscription.

  - `metadata` (object)
    Additional metadata for the subscription.

This property lets you add custom data to the subscription.
The key has a limit of 40 characters and the value has a limit of 500 characters.

## Response 400 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response 409 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response default fields (application/json):

  - `message` (string, required)

  - `code` (string, required)