# Create Subscription

This endpoint creates a new webhook subscription to receive real-time notifications for specified events.
The request body requires a `CreateSubscriptionRequest` object, which includes the `url` for the webhook, the `events` to subscribe to, and a `shared_secret` for verifying request signatures.

Endpoint: POST /api/v1/subscriptions/
Version: Version: cf52545e
Security: CodeBearer

## Request fields (application/json):

  - `description` (string)
    A description of the webhook's intended use.

  - `events` (array, required)
    Which types of events this webhook should be invoked for.

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

  - `retry_policy` (any)
    The retry policy to use if Jiko encounters HTTP errors when calling subscription URLs.

  - `retry_policy.retry_on_status_codes` (array, required)
    Denotes on which status codes Jiko will retry the webhook call, e.g. 502 or 503.

  - `retry_policy.backoff_coefficient` (number, required)

  - `retry_policy.maximum_attempts` (integer, required)

  - `retry_policy.initial_interval_seconds` (number, required)

  - `retry_policy.maximum_interval_seconds` (number, required)

  - `shared_secret` (string, required)
    The shared secret used by the Partner API to sign requests made to the webhook. The shared secret needs to be minimum 16 characters long.

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)