# Create or update webhook

Creates or updates the Webhook for the company. Only one webhook per company and partner.
The Webhook will POST to the provided URL whenever a candidate check created using the same partner (unless global) changes status.

Endpoint: POST /webhooks
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `uri` (string, required)
    Example: "https://your_webhook_uri/endpoint"

  - `id_in_path` (boolean)
    Send partner_application_id in path
    Example: true

  - `global` (boolean)
    Set it to true if you want to receive notifications indistinctly the partner it was created from

  - `authorization` (string)
    Value for Authorization header
    Example: "Bearer your_authorization_token"

  - `headers` (object)

## Response 200 fields (application/json):

  - `result` (object)

  - `result.uri` (string, required)
    Example: "https://your_webhook_uri/endpoint"

  - `result.id_in_path` (boolean)
    Send partner_application_id in path
    Example: true

  - `result.global` (boolean)
    Set it to true if you want to receive notifications indistinctly the partner it was created from

  - `result.authorization` (string)
    Value for Authorization header
    Example: "Bearer your_authorization_token"

  - `result.headers` (object)

  - `status` (integer)
    Example: 200

  - `error` (object,null)