# 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="https://1779874722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTw0qpCVzfrIXqS4FEg4T%2Fuploads%2Fgit-blob-b94cde1be376f8b0143617713fe19493df07aec7%2Fimage.png?alt=media" 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 %}