> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keephq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana OnCall Provider

> Grafana Oncall Provider is a class that allows to ingest data to the Grafana OnCall.

## Authentication

This provider requires authentication.

* **token**: Token (required: True, sensitive: False)
* **host**: Grafana OnCall Host (required: True, sensitive: False)

## In workflows

This provider can be used in workflows.

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query grafana_oncall
      provider: grafana_oncall
      config: "{{ provider.my_provider_name }}"
      with:
        title: {value}  
        alert_uid: {value}  
        message: {value}  
        image_url: {value}  
        state: {value}  
        link_to_upstream_details: {value}  
```

If you need workflow examples with this provider, please raise a [GitHub issue](https://github.com/keephq/keep/issues).

## Connecting with the Provider

To connect to Grafana OnCall, you need to create an API Token:

1. Log in to your Grafana account.
2. Go To "Alerts & IRM" -> OnCall.
3. Go to the **Settings** page.
4. Click the **Create** button and provide a name for your token.
5. Copy the token value and keep it secure.
6. Add the token value to the `authentication` section in the Grafana Oncall Provider configuration.

## Notes

* This provider allows you to interact with Grafana OnCall to create alerts.
* Keep will create "Webhook" type integration called "Keep Integration" inside Grafana OnCall.

Payload example:

```json theme={null}
{
    "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!"
}
```

## Useful Links

* [Grafana OnCall Inbound Webhook Integration](https://grafana.com/docs/oncall/latest/configure/integrations/references/webhook/)