---
title: "Configure Grafana IRM for Alerting | Grafana Cloud documentation"
description: "Configure the Alerting - Grafana IRM integration to connect alerts generated by Grafana Alerting with Grafana IRM"
---

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

# Configure Grafana IRM for Alerting

Use the Grafana IRM integration in contact points to send alerts to [Grafana IRM](/docs/grafana-cloud/alerting-and-irm/irm/). You can then route them based on the escalation chains and schedules defined in Grafana IRM.

## Before you begin

Make sure Grafana IRM is activated in your Grafana Cloud instance.

Note that the Grafana IRM contact point is only available when using the built-in Grafana Alertmanager.

To configure Grafana IRM with Grafana OSS or Grafana Enterprise, refer to the [Grafana OSS documentation](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/configure-irm/).

## Configure Grafana IRM for a contact point

To create a contact point with a Grafana IRM integration, complete the following steps:

1. Navigate to **Alerts & IRM** -> **Alerting** -> **Contact points**.
2. Click **+ Add contact point**.
3. Enter a name for the contact point.
4. From the **Integration** list, select **Grafana IRM**.
5. Choose whether to add a new IRM integration or add an existing one.
   
   - If you add a new one, enter an integration name.
   - If you add an existing one, choose from the list of available integrations.
6. (Optional) Configure [optional settings](#optional-settings).
7. Click **Save contact point**.

For more details on contact points, including how to test them and enable notifications, refer to [Configure contact points](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/).

### Optional settings

The IRM contact point in Grafana Alerting integrates with Grafana IRM using webhook requests. The following settings allow you to customize webhook requests when needed.

Expand table

| Key                               | Description                                                                                                             |
|-----------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| HTTP Method                       | Specifies the HTTP method to use: `POST` or `PUT`.                                                                      |
| Basic Authentication Username     | Username for HTTP Basic Authentication.                                                                                 |
| Basic Authentication Password     | Password for HTTP Basic Authentication.                                                                                 |
| Authentication Header Scheme      | Scheme for the `Authorization` Request Header. Default is `Bearer`.                                                     |
| Authentication Header Credentials | Credentials for the `Authorization` Request header.                                                                     |
| Max Alerts                        | Maximum number of alerts to include in a notification. Any alerts exceeding this limit are ignored. `0` means no limit. |

### Optional payload settings

The IRM contact point sends alert messages to Grafana IRM using the [JSON payload format used by the webhook integration](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/#json-payload):

JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```json
{
  "orgId": 1,
  "state": "alerting",
  "title": "[FIRING:1] TestAlert Grafana ",
  "alerts": [
    {
      "endsAt": "0001-01-01T00:00:00Z",
      "labels": {
        "instance": "Grafana",
        "alertname": "TestAlert"
      },
      "status": "firing",
      "values": null,
      "panelURL": "",
      "startsAt": "2025-04-07T14:42:52.388041666Z",
      "silenceURL": "https://alerttest.grafana.net/alerting/silence/new?alertmanager=grafana&matcher=alertname%3DTestAlert&matcher=instance%3DGrafana",
      "annotations": {
        "summary": "Notification test"
      },
      "fingerprint": "57c6d9296de2ad39",
      "valueString": "[ metric='foo' labels={instance=bar} value=10 ]",
      "dashboardURL": "",
      "generatorURL": ""
    }
  ],
  "status": "firing",
  "message": "**Firing**\n\nValue: [no value]\nLabels:\n - alertname = TestAlert\n - instance = Grafana\nAnnotations:\n - summary = Notification test\nSilence: https://alerttest.grafana.net/alerting/silence/new?alertmanager=grafana&matcher=alertname%3DTestAlert&matcher=instance%3DGrafana\n",
  "version": "1",
  "groupKey": "test-57c6d9296de2ad39-1744036972",
  "receiver": "test",
  "numFiring": 1,
  "externalURL": "https://alerttest.grafana.net/",
  "groupLabels": {
    "instance": "Grafana",
    "alertname": "TestAlert"
  },
  "numResolved": 0,
  "commonLabels": {
    "instance": "Grafana",
    "alertname": "TestAlert"
  },
  "truncatedAlerts": 0,
  "commonAnnotations": {
    "summary": "Notification test"
  }
}
```

You can also customize some fields in the JSON payload using [notification templates](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/).

Expand table

| Option  | Description                                                                                                                                                                                               |
|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Title   | Sends the value as a string in the `title` field of the JSON payload. Supports [notification templates](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/).   |
| Message | Sends the value as a string in the `message` field of the JSON payload. Supports [notification templates](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/). |

> Note
> 
> A Grafana IRM contact point can either create or use a Grafana Alerting integration from your Grafana IRM account.
> 
> The Grafana Alerting integration in IRM includes preconfigured templates that automatically process JSON messages sent from Grafana Alerting. For additional details, refer to [Configure IRM alert templates](/docs/grafana-cloud/alerting-and-irm/irm/configure/escalation-routing/alert-templates/).

### Optional notification settings

Expand table

| Key                      | Description                                                         |
|--------------------------|---------------------------------------------------------------------|
| Disable resolved message | Enable this option to prevent notifications when an alert resolves. |