# Webhooks

## Overview

You can use webhooks to send check-ins data back to specific URLs to build integration with Tability.

## How to use webhooks

{% hint style="warning" %}
Available on **Premium** subscription
{% endhint %}

Webhooks are available:

* At the workspace level: you will get notifications whenever a check-in is created
* At a key result/outcome level: you will get notifications whenever a check-in is created for a specific key result

### Handling our webhook notifications

The endpoint used for the webhook must accept POST request and return a 200 response.

If your webhook endpoint fails to return a 200 then:

* You won't be able to create the webhook
* The webhook will be suspended if it was already created

### How to add a workspace webhook

1. Go to your **Workspace Settings** > **Webhooks**
2. Click on **Add webhook**
3. Enter the URL of your webhook
4. Click **Test** to validate that your URL. This will send a test POST request to your URL
5. Once the test is successful, click on **Add** to create your webhook

### How to add a key result webhook

1. Go to your key result
2. Click on **Edit** from the option menu
3. Go to the **Notifications** tab
4. Add your webhook URL in the form
5. Click **Test** to validate that your URL. This will send a test POST request to your URL
6. Once the test is successful, click on **Add** to create your webhook


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.tability.io/docs/become-a-tability-power-user/integrations/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.