# Webhooks integration

When we raise an incident alert, we can also send it to a URL of your choice once it is set up in your organization.

#### Setting Up Webbooks

**URL Validation**: When setting up webhooks, it's essential to ensure the URL you provide is accurate. Validate your URL by clicking the "`Test`" button. A successful test ensures proper integration.

**HTTP Header and Token**: Additionally, make sure to provide a valid HTTP Header and associated token for effective and secure webhook functionality.

<figure><img src="/files/oj594Ai1iqt5pdwgUBf8" alt=""><figcaption></figcaption></figure>

### Sample payload

This is a sample payload in `json` which will be sent to the webhook.

{% hint style="info" %}
If you would like to use the below payload to build a URL to the Incidents detail page in Decube, you can do so by using the following parameters: https\://{region}.decube.io/incidents/{"incident":{"id"}}

Example output: <https://apac.decube.io/incidents/17>
{% endhint %}

{% code overflow="wrap" %}

```json
{
  "organization_id": "abc1234", 
  "asset": {
    "asset": {
      "id": 1506,
      "type": "property",
      "name": "country"
    },  // This is the catalog asset that this monitor is added to.
    "parents": [
      {
        "id": 11,
        "type": "source",
        "name": "Ironhide-test"
      },
      {
        "id": 44,
        "type": "collection",
        "name": "public"
      },
      {
        "id": 206,
        "type": "dataset",
        "name": "bank"
      }
    ]
  }, // This is the parent object(s) of the catalog asset.
  "incident": {
    "case_id": 1872,
    "id": 169775,
    "time": "2025-10-16T15:21:24.513618",
    "type": "field_health",
    "test_type": "null_percentage",
    "level": "critical"
  }, // Incident information as shown in Incidents page
  "monitor": {
    "id": 41076,
    "name": "null_percentage",
    "mode": "scheduled",
    "grouping": null
  }, // Basic information on monitor which created the incident.
  "detail": {
    "value": 0,
    "upper_bound": 60,
    "lower_bound": 50,
    "test_type": "null_percentage",
    "metric_name": "null_percentage"
  }
} // Metrics from the scan which generated the incident.
```

{% endcode %}


---

# 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://docs.decube.io/alert-notifications/webhooks-integration.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.