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

# Pingdom

> Receive uptime and transaction alerts from Pingdom via webhook.

| Property         | Value    |
| ---------------- | -------- |
| **Type**         | Incoming |
| **Level**        | Service  |
| **Auto-resolve** | Yes      |

Pingdom sends state-change notifications to Warrn via webhook. When a check goes DOWN, Warrn creates an alert. When the check returns to UP, Warrn auto-resolves the matching alert.

## Setup

<Steps>
  <Step title="Add the integration in Warrn">
    Open a service or team in Warrn. Go to the **Integrations** tab, add **Pingdom**,. Copy the generated webhook URL.
  </Step>

  <Step title="Create a webhook integration in Pingdom">
    In Pingdom, go to **Integrations > Integrations**. Click **Add integration** and select **Webhook**. Paste the webhook URL from Warrn and save.
  </Step>

  <Step title="Assign the webhook to your checks">
    In Pingdom, open the uptime or transaction check you want to monitor. Under **Alerting**, add the webhook integration you just created.
  </Step>
</Steps>

## How it works

Pingdom sends a JSON payload for each state change. The `current_state` field determines the action:

* **DOWN** (or any non-UP state): Creates a new alert in Warrn. Deduplicates by `check_id`.
* **UP**: Auto-resolves the matching Warrn alert.

### Field mapping

| Pingdom field                                        | Warrn field                                   |
| ---------------------------------------------------- | --------------------------------------------- |
| `check_name` + state + hostname                      | Alert name                                    |
| `long_description`, check type, URL, probe locations | Description                                   |
| `importance_level`                                   | Severity (mapped, see below)                  |
| `check_id`                                           | Alert alias (used for dedup and auto-resolve) |
| Check type, Pingdom tags, hostname                   | Tags                                          |

## Severity mapping

| Pingdom importance        | Warrn severity |
| ------------------------- | -------------- |
| `high`                    | high           |
| `low`                     | low            |
| (missing or unrecognized) | high           |
