> ## Documentation Index
> Fetch the complete documentation index at: https://checkly-422f444a-herve-ai-557-agentic-check-migration-guide.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating StatusPage

> Configure StatusPage integration to automatically open incidents when Checkly monitors fail

Checkly's webhooks can be used to automatically open incidents with [StatusPage](https://www.atlassian.com/software/statuspage). Assuming you already have your status page set up, the setup is as follows:

1. First of all, ensure you have an API key available for your status page. In case you don't, [create a new one](https://support.atlassian.com/statuspage/docs/create-and-manage-api-keys/). You will also need to make a note of your status page's id.

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage-api-page.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=aa5c1b2a52bb3d831c19b2cc30fd80b2" alt="status page api details page" width="2310" height="1558" data-path="images/docs/images/integrations/statuspage/statuspage-api-page.png" />

2. Next up, navigate to the Alert Settings tab on Checkly and add a new channel.

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage_add_alert.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=2d41ab6e16338e7299ce0bf20a10bf02" alt="checkly create alert" width="2100" height="886" data-path="images/docs/images/integrations/statuspage/statuspage_add_alert.png" />

3. Select `Webhook`.

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage_alert_channels.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=044f6e8a370d7ece8e2abe87490013e6" alt="checkly create webhook for statuspage" width="2170" height="960" data-path="images/docs/images/integrations/statuspage/statuspage_alert_channels.png" />

4. Configuring the webhook, enter `POST` as method and `https://api.statuspage.io/v1/pages/<YOUR_PAGE_ID>/incidents` as URL. The body needs to be configured as shown in StatusPage's [official documentation](https://developer.statuspage.io/#operation/postPagesPageIdIncidents).

An example could be:

```json theme={null}
{
  "incident": {
    "name": "{{ALERT_TITLE}}",
    "status": "investigating",
    "impact_override": "critical",
    "metadata": {},
    "deliver_notifications": true,
    "auto_tweet_at_beginning": false,
    "auto_tweet_on_completion": false,
    "auto_tweet_on_creation": false,
    "auto_tweet_one_hour_before": false,
    "backfill_date": "string",
    "backfilled": false,
    "body": "Something broke :(",
    "components": {},
    "component_ids": [],
    "scheduled_auto_transition": false
  }
}
```

Where the `name` field will be set to the title of the Checkly alert. See all [available alert variables](/integrations/alerts/webhooks#using-variables).

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage_body_url.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=c374acf580640cbf4c88cb16399f6726" alt="checkly statuspage webhook body and url" width="2210" height="1270" data-path="images/docs/images/integrations/statuspage/statuspage_body_url.png" />

5. You will also need to provide your StatusPage API key in the `Authorization` header in the Headers tab, as well as select on which status the webhook should fire ("when a check fails", in this case), and which checks/groups should subscribe to the webhook. Subscribed checks and groups will trigger the webhook and open an incident.

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage_header_auth.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=7fd1c2c72621a1d7739fc3f1742579af" alt="checkly webhook authorization header for statuspage" width="2172" height="1334" data-path="images/docs/images/integrations/statuspage/statuspage_header_auth.png" />

You are done! When a subscribed check fails, an incident will be opened on StatusPage:

<img src="https://mintcdn.com/checkly-422f444a-herve-ai-557-agentic-check-migration-guide/n1vBMP1vnWCtGuP9/images/docs/images/integrations/statuspage/statuspage_end_result.png?fit=max&auto=format&n=n1vBMP1vnWCtGuP9&q=85&s=80830ab266adfff1ffd15009f2eb3c1c" alt="checkly statuspage integration end result" width="1758" height="1430" data-path="images/docs/images/integrations/statuspage/statuspage_end_result.png" />

<Callout type="note">
  Note that currently, automatically resolving existing incidents on check recovery is not supported.
</Callout>

Congratulations! You have successfully integrated Checkly with StatusPage!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.