# Create Webhook Subscription

Create a Webhook Subscription.

Endpoint: POST /v1/webhooks
Version: v1
Security: ApiKeyAuth

## Request fields (application/json):

  - `name` (string, required)
    The Webhook Subscription name

  - `events` (array)
    The set of events this Webhook Subscription subscribes to. Allowed values: [SLAEvaluationVoided, ConversationPending, SLAEvaluationBreached, ConversationMessageAdded, ConversationCustomAttributeUpdated, SLAEvaluationAchieved, ConversationAssigned, ConversationMessageDeliveryDelivered, ConversationMessageDeliveryInfo, ConversationTransferred, ConversationEnqueued, AgentUnbannedEnduser, TypingStarted, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationMessageDeliveryFailed, ConversationTagAdded, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, ConversationMessageDeliverySeen, AgentUnbannedIp, ConversationMessageDeliverySent, AgentBannedIp, ConversationTagRemoved, ConversationRated, SLAEvaluationPending, ConversationMessageDeliverySpamComplaint, ConversationPendingExpired]

  - `url` (string, required)
    URL of the server that the webhook request should be sent to

  - `authorization` (any, required)
    Authorization to be added as a header in the webhook request. Can be either, Basic auth, added as 'Basic base64encoded(\:\)', Token auth, added as 'Bearer \', or no auth

  - `customHeaders` (object, required)

  - `enabled` (boolean)
    Defines whether this Webhook Subscription is enabled or disabled. Default is true

  - `filters` (object)

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)
    The Webhook Subscription ID

  - `data.name` (string, required)
    The Webhook Subscription name

  - `data.subscribedEvents` (array)
    The set of events this Webhook Subscription is subscribed to

  - `data.url` (string, required)
    URL of the server that the webhook request should be sent to

  - `data.headers` (object, required)
    The headers that will be added to the webhook request

  - `data.secretKey` (string, required)
    Dixa generated secret key, used to sign the requests

  - `data.enabled` (boolean, required)
    Defines whether this Webhook Subscription is enabled or disabled

  - `data.createdAt` (string, required)
    Date when this Webhook Subscription was created

  - `data.createdBy` (string, required)
    The ID of the user who created this Webhook Subscription

  - `data.updatedAt` (string, required)
    Date when this Webhook Subscription was last updated

  - `data.updatedBy` (string, required)
    The ID of the user who last updated this Webhook Subscription

  - `data.filters` (object)

## Response 400 fields (application/json):

  - `message` (string, required)

## Response 500 fields (application/json):

  - `message` (string, required)