# GitHub Actions to Pagerless

> Paste one URL into GitHub Actions. Pagerless decides who to wake, explains it in plain words and closes the problem when GitHub Actions says it's fixed.

URL: https://pagerless.dev/integrations/github-actions
Updated: 2026-10-22

## Set up

Your URL is in the Pagerless app under Other tools, with the key filled in:

```text
https://events.pagerless.dev/v1/hooks/github/<your ingest key>
```

1. **Open Repository settings, Webhooks** In GitHub Actions.
2. **Add a webhook with your Pagerless URL, content type JSON.** 
3. **Secret: your ingest key.** 
4. **Events: Workflow runs.** 

## What happens

| When | Pagerless |
| --- | --- |
| Fires | A workflow run on the default branch that ends in failure, timed out or startup failure |
| Clears | The next successful run |
| How loud | Set with `?level=` on the URL |
| Proof it's you | `X-Hub-Signature-256`, checked when sent. |

Other branches, pull requests and cancelled runs are ignored, so only a broken main reaches you.

## Choosing who gets woken

| Rule | Example |
| --- | --- |
| Name rules on the URL | `?wake=prod-*&log=*-staging` (globs, case-insensitive) |
| The tool's own severity | critical, p1, sev1, fatal wake; error, warning tell; info, low log |
| A default on the URL | `?level=wake` (or tell, log). Without one: tell. |

`?service=` and `?env=` set the service and environment shown on the problem.