Webhooks integration

Receive your decube alerts to an endpoint of your choice by using our 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.

Sample payload

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

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

{
  "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.