Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Grafana OnCall Connect to Grafana OnCall Use webhooks to send and receive alerts Webhook integration

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

   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!"
   }'
       ```