Set up
Your URL is in the Pagerless app under Other tools, with the key filled in:
https://events.pagerless.dev/v1/hooks/github/<your ingest key>Open Repository settings, Webhooks
In GitHub Actions.
Add a webhook with your Pagerless URL, content type JSON.
Secret: your ingest key.
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.