# Create a new webhook

Endpoint: POST /api/v1/webhooks
Version: 0.0.1
Security: user_session, form_session, component_session, component_token, api_token

## Request fields (application/json):

  - `url` (string, required)

  - `description` (string)

  - `subscribed_events` (array)
    Enum: "employee.created", "employee.updated", "employee.deleted", "employer.created", "employer.updated", "employer.deleted", "client.created", "client.updated", "client.deleted", "job.created", "job.updated", "job.deleted", "task.created", "task.updated", "task.deleted", "task.form_pdf_generated", "placement.created", "placement.updated", "placement.deleted"

## Response 201 fields (application/json):

  - `id` (string, required)
    Webhook Identifier

  - `url` (string, required)

  - `token` (string, required)

  - `description` (any, required)

  - `created_at` (string, required)
    a string to be decoded into a DateTime.Utc

  - `updated_at` (string, required)
    a string to be decoded into a DateTime.Utc

  - `last_used_at` (any, required)

  - `subscribed_events` (array, required)
    Enum: "employee.created", "employee.updated", "employee.deleted", "employer.created", "employer.updated", "employer.deleted", "client.created", "client.updated", "client.deleted", "job.created", "job.updated", "job.deleted", "task.created", "task.updated", "task.deleted", "task.form_pdf_generated", "placement.created", "placement.updated", "placement.deleted"

## Response 401 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Unauthorized"

## Response 403 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Forbidden"