# Register webhook

Register a new webhook and receive callbacks.

Endpoint: POST /api/admin/webhooks
Version: EAP
Security: APIKey, AdminToken

## Request fields (application/json):

  - `events` (array, required)
    The list of events to subscribe to.
    Enum: "network.token.updated", "pci.token.security-code.expired"

  - `hmac_key` (string)
    The HMAC key to be used to sign the payloads sent to the webhook URL.

  - `url` (string, required)
    The URL to which the webhook will send event notifications.

## Response 200 fields (application/json):

  - `id` (string, required)
    The unique identifier for the webhook.

  - `created_at` (string, required)
    The timestamp when the webhook was created.

  - `events` (array, required)
    The list of events the webhook is subscribed to.
    Enum: "network.token.updated", "pci.token.security-code.expired"

  - `masekd_hmac_key` (string)
    The masked HMAC key used to sign the payloads sent to the webhook URL.
    Example: "123xxxx"

  - `url` (string, required)
    The URL to which the webhook sends event notifications.

## Response 401 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

## Response 403 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

## Response 422 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

  - `validation_errors` (array)

  - `validation_errors.path` (string)
    Json-path in the request which points to the validation error

  - `validation_errors.message` (string)
    Human readable validation message