---
title: "Webhook integration | Grafana OnCall documentation"
description: "Integrate with your data source using webhooks Grafana OnCall directly supports integrations from many data sources, but you can connect to any data source that isn’t listed in the Create Integration page by using webhooks."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Integrate with your data source using webhooks

Grafana OnCall directly supports integrations from many data sources, but you can connect to any data source that isn’t listed in the **Create Integration** page by using webhooks.

1. In **Integrations**, click **+ New integration for receiving alerts**.
2. Select a webhook format. There are two available formats. **Webhook** and **Formatted Webhook**.
   
   - **Webhook** will pull all of the raw JSON information and display it in the manner that it is received.
   - **Formatted Webhook** can be used if the body of the alerts sent by your monitoring service are formatted in a way that OnCall can read. The following fields are recognized, but none are required:
     
     - `alert_uid`: a unique alert ID for grouping.
     - `title`: a title.
     - `image_url`: a URL for an image attached to alert.
     - `state`: either `ok` or `alerting`. Helpful for auto-resolving.
     - `link_to_upstream_details`: link back to your monitoring system.
     - `message`: alert details.
3. Use the unique webhook URL for requests. For example:
   
   JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ````json
   curl -X POST \
   https://a-prod-us-central-0.grafana.net/integrations/v1/formatted_webhook/m12xmIjOcgwH74UF8CN4dk0Dh/ \
   -H 'Content-Type: Application/json' \
   -d '{
       "alert_uid": "08d6891a-835c-e661-39fa-96b6a9e26552",
       "title": "The whole system is down",
       "image_url": "https://upload.wikimedia.org/wikipedia/commons/e/ee/Grumpy_Cat_by_Gage_Skidmore.jpg",
       "state": "alerting",
       "link_to_upstream_details": "https://en.wikipedia.org/wiki/Downtime",
       "message": "Smth happened. Oh no!"
   }'
       ```
   ````