Custom Alerts

If you use an alerting provider that isn’t supported by an Unpage plugin, you can still send alert payloads to your Unpage agents via webhooks.

1. Start your Unpage Server

   Start your server with uv run unpage agent serve .

   During development you can tunnel to your local Unpage instance using ngrok by running uv run unpage agent serve --tunnel (see Unpage Server for details).

2. Create a webhook through your alerting provider

   The webhook URL should be the hostname of your running Unpage Server, with a path of /webhook (like https://unpage.yourdomain.com/webhook).

   The webhook should send whatever events you want to run Agent workflows on, for example incident.triggered.

Unpage will now receive webhooks from your alerting provider and send them to the Router, which will decide which Agent workflow to run.

Our Plugins include tools that allow agents to comment on and resolve alerts; for full plugin support for your alerting provider, send us a feature request on GitHub.