# Webhooks

{% admonition type="info" name="Webhooks are unique per partner and company!" %}
  Only one webhook can exists for a partner and company. You will only get updates notifications on candidates created under this context.

  E.g. If you subscribe to a webhook using your __Account API token__ you won't be get notified about updates on candidates created directly on the web application or other partners.
{% /admonition %}

{% admonition type="info" name=":global parameter" %}
  `:global` parameter is the only exception to the above. If `global=true` you will get notifications on all candidates created through the API. 
  You still won't get notifications on candidates created from the web application as they don't belog to the API.
{% /admonition %}


## Create or update webhook

 - [POST /webhooks](https://docs.checkmate.tech/api/webhooks/createorupdatewebhook.md): 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.