> ## Documentation Index
> Fetch the complete documentation index at: https://docs.redbrickai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

Webhooks allow you to receive an HTTP push notification triggered by certain events within a project. Currently, webhooks are triggered by the following events: 

1. **Task created**: When a data point is uploaded, and a task is created from that data point. 
2. **Task entered stage**: When a task enters a new stage in the labeling workflow.
3. **Task deleted**: When a task is deleted.

<Tabs>
  <Tab title="Task created">
    ```json theme={null}
    {
      "version": "v1.0",
      "events": 1,
      "payload": [
        {
          "event": "TASK_CREATED",
          "id": "...",
          "timestamp": ...,
          "data": {
            "orgId": "...",
            "projectId": "...",
            "taskId": "...",
            "taskName": "...",
            "updatedBy": "..."
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Task entered stage">
    ```json theme={null}
    {
      "version": "v1.0",
      "events": 1,
      "payload": [
        {
          "event": "TASK_ENTERED_STAGE",
          "id": "...",
          "timestamp": ...,
          "data": {
            "orgId": "...",
            "projectId": "...",
            "taskId": "...",
            "stageName": "...",
            "updatedBy": "..."
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Task deleted">
    ```
    {
      "version": "v1.0",
      "events": 1,
      "payload": [
        {
          "event": "TASK_DELETED",
          "id": "...",
          "timestamp": ...,
          "data": {
            "orgId": "...",
            "projectId": "...",
            "taskId": "...",
            "taskName": "...",
            "updatedBy": "..."
          }
        }
      ]
    }
    ```
  </Tab>
</Tabs>

## Using Webhooks

Configure a webhook from the Project Settings, as shown in the image below.&#x20;

<Frame>
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/ZdKrDiZOOdWhNNT4/assets/images/project-pages/settings-page/webhook.png?fit=max&auto=format&n=ZdKrDiZOOdWhNNT4&q=85&s=77f07e7d85c0114d6797a9fae820fbc9" alt="" width="3190" height="1810" data-path="assets/images/project-pages/settings-page/webhook.png" />
</Frame>

You can use tools like [https://webhook.site/](https://webhook.site/#!/view/8df76e5a-9a58-4394-8c65-854d305bb5be) to test the webhook and inspect the response format.&#x20;