> This page is for Taurus PROTECT, version v3.52.
> For other versions, use one of these documentation indexes:
> - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt
> - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt
> - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt
> - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt
> - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt
> - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt
> - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt
> - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt
> - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt
> - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt
> - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server.

# Creating a configuration

A new webhook configuration is created by making an HTTP POST call to \<server.url>/api/rest/v1/webhooks. The following parameters are accepted:

| Key    | Example of Value                          | Note                                                                  | Required |
| :----- | :---------------------------------------- | :-------------------------------------------------------------------- | :------- |
| type   | requestStatus.updated                     | Specifies the type of event that the application will be informed of. | Yes      |
| url    | https\://\[client.url]                    | An HTTPS URL of the application that shall receive webhook calls.     | Yes      |
| secret | A shared secret up to 150 characters long | A symmetric key used to produce authentication signatures.            | No       |

**Example**:

```
{
    "type": "requestStatus.updated",
    "url": "https://[client-url]",
    "secret": "Your secret"
}
```

\


> **Tip**
>
> **Tip**
>
> You can either provide a secret when creating webhooks or you can omit it and allow tg-validatord to provide one for you.
>
> The secret will only be communicated during webhook creation, and it will be passed in plaintext within the creation call. If you omit the shared secret, tg-validatord will use a random base64 string of 45 characters. This string will be used as is without decoding. It will be returned via the API once the creation is successful.

**Example response**:

```
// 200 OK
{
    "webhook": {
        "id": "44c085b7-dc60-42f7-98fe-ee776aaf5b24",
        "type": "requestStatus.updated",
        "url": "https://[client-url]",
        "status": "enabled",
        "createdAt": "2024-05-29T12:07:56.558167Z"
    },
    "secret": "erQ/wIuSOacrmwkOPrrcEAb1E5bPc3AJIThbqkFRwmU="
}
```