DevBarDevBar

Webhooks

Receive real-time events from PagerDuty, GitHub, Datadog, and any system that can send JSON.

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

  1. 1Go to Dashboard → Webhooks and create a webhook token. Give it a label, choose the sender it is for, and pick the scope (just you, a team, or your organisation).
  2. 2Copy the token right away — it starts with whk_ and is shown only once.
  3. 3Build the webhook URL for your source system: https://api.devbar.app/webhooks/<pagerduty | github | datadog | inbound>?token=<your-token>
  4. 4Paste that URL into your external system's webhook configuration.
  5. 5Events arrive instantly in DevBar — no restart needed. Without a token, events are broadcast to every connected client, so always include one.

Supported platforms

PagerDuty

Webhook URL

https://api.devbar.app/webhooks/pagerduty?token=<your-token>

Events DevBar understands

  • incident.trigger
  • incident.acknowledge
  • incident.resolve
  • incident.assign

Note: Use a PagerDuty V2 webhook subscription pointed at this URL.

GitHub

Webhook URL

https://api.devbar.app/webhooks/github?token=<your-token>

Events DevBar understands

  • pull_request opened
  • pull_request review_requested
  • pull_request closed (reported as merged or closed)
  • check_run completed
  • push

Note: When the server has a GitHub webhook secret configured, requests must carry a valid X-Hub-Signature-256 header, and the X-GitHub-Event header is always required. Set the same secret in your GitHub webhook settings.

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
  • Alert types: error, warning, success, info

Note: Use Datadog's webhook integration with the default payload so alert_transition and alert_type are included.

Generic (inbound)

Webhook URL

https://api.devbar.app/webhooks/inbound?token=<your-token>

Events DevBar understands

  • Structured JSON event: tab, title (required), message, severity (info | warning | error)

Note: Use this for any system that is not listed above. The event reaches your menu bar as an inbound event.

Generic / Custom systems

For systems not listed above, POST a small JSON document to the inbound endpoint. title is required; tab, message and severity are optional. Create a token in Dashboard → Webhooks and use it as the token query parameter.

curl -X POST "https://api.devbar.app/webhooks/inbound?token=<your-token>" \
  -H "Content-Type: application/json" \
  -d '{"tab":"alerts","title":"Deploy failed","message":"Step build failed on main","severity":"error"}'

The response is { "received": true }. Requests without a title are rejected with 400.

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.