# Creates a webhook

Creates a Webhook object.

A webhook needs to have a ,  and a . By default the Webhook will be active and subscribed to all event types. You can add the parameter  to  to make it inactive.

Endpoint: POST /webhooks
Version: v1
Security: apiKey

## Request fields (application/json):

  - `description` (string)
    Description of the webhook. It describes what this webhook is used for.
    Example: "Webhook description"

  - `name` (string)
    Name of the webhook.
    Example: "Webhook name"

  - `url` (string)
    The URL of the webhook endpoint
    Example: "https://www.example.org/webhook"

  - `active` (boolean,null)
    When  is  this webhook endpoint will receive events.
    Example: true

  - `enabled_event_types` (array,null)
    Event types that will be sent to the webhook endpoint. If  are not supplied, all event types will be sent. Also, you can supply  to enable all event types.
    Example: ["all"]

## Response 201 fields (application/json):

  - `id` (string, required)
    Example: "WHXFPVRLXYL3U7"

  - `type` (string, required)
    Enum: "webhook"

  - `name` (string, required)
    Example: "Webhook Name"

  - `description` (string, required)
    Example: "Webhook Description"

  - `active` (boolean, required)
    Example: true

  - `url` (string, required)
    Example: "https://example.com/webhook"

  - `secret` (string, required)
    Example: "V9xVoX4sVJE8x41hATbFYZJ5qd6HALhN"

  - `enabled_event_types` (array)
    Enum: "customer.created", "customer.updated", "chargeback.created", "payout.created", "payout.approved", "payout.rejected", "payout.failed", "payout.paid", "payment.created", "payment.started", "payment.canceled", "payment.failed", "payment.paid", "payment.expired", "refund.created", "refund.canceled", "refund.failed", "refund.refunded", "refund.expired", "subscription.created", "subscription.started", "subscription.canceled", "subscription.paused", "subscription.resumed", "subscription.updated", "subscription.completed", "installment_plan.created", "installment_plan.started", "installment_plan.canceled", "installment_plan.paused", "installment_plan.resumed", "installment_plan.updated", "installment_plan.completed", "topup.created", "topup.started", "topup.canceled", "topup.failed", "topup.paid", "topup.expired"

  - `created_at` (string, required)
    Example: "2023-06-30T12:40:10Z"

  - `_links` (object, required)
    Example: {"self":"https://api.paypro.nl/webhooks/WHXFPVRLXYL3U7"}

  - `_links.self` (string, required)
    Example: "https://api.paypro.nl/webhooks/WHXFPVRLXYL3U7"