Webhooks
Receive real-time events from PagerDuty, GitHub, Datadog, and more via webhooks.
Overview
Webhooks let any external system push events directly into DevBar. When a webhook fires, DevBar receives it instantly and surfaces a notification in your Mac menu bar — no polling, no delay. Each webhook token is scoped to a specific user or org, so events reach only the people who need them.
How it works
- 1Go to Dashboard → Webhooks and create a webhook token. Choose the platform, scope, and add an optional label.
- 2Choose the platform that matches your source system (PagerDuty, GitHub, Datadog, Grafana, CircleCI — or Generic for anything else).
- 3You receive a webhook URL in the form: https://api.devbar.app/webhooks/<platform>?token=<your-token>
- 4Paste that URL into your external system's webhook configuration.
- 5Events arrive instantly in DevBar — no restart needed.
Supported platforms
PagerDuty
Webhook URL
https://api.devbar.app/webhooks/pagerduty?token=<your-token>Events DevBar understands
- incident.triggered
- incident.acknowledged
- incident.resolved
- incident.assigned
GitHub
Webhook URL
https://api.devbar.app/webhooks/github?token=<your-token>Events DevBar understands
- pull_request opened
- pull_request review_requested
- pull_request merged
- pull_request closed
- check_run completed
- push
Note: Requires X-Hub-Signature-256 validation — a shared secret is set when creating the token in Dashboard → Webhooks.
Datadog
Webhook URL
https://api.devbar.app/webhooks/datadog?token=<your-token>Events DevBar understands
- Monitor alert triggered
- Monitor alert recovered
- Monitor alert no_data
- Monitor alert warning
Grafana
Webhook URL
https://api.devbar.app/webhooks/grafana?token=<your-token>Events DevBar understands
- Alert firing
- Alert resolved
CircleCI
Webhook URL
https://api.devbar.app/webhooks/circleci?token=<your-token>Events DevBar understands
- workflow-completed
- job-completed
Generic / Custom systems
For systems not listed above, DevBar provides a generic endpoint that accepts any JSON payload and surfaces it as a general notification in your menu bar. Create a token with the generic platform in Dashboard → Webhooks and use the resulting URL with your system.
Token security
Tokens are scoped to your user or your org — events only reach you (or your team), not the whole platform.
Treat the webhook URL like a password — anyone with the URL can push events to your DevBar.
If a token is compromised, delete it immediately in Dashboard → Webhooks.