Any system can ring the room.

Every room hands out webhook URLs. Anything that can send a POST (a CI pipeline, a payment processor, a smart sensor) can fire a Ping.

How it works

Grab the URL

Create up to four incoming webhooks per room with Pro. Each has its own secret URL and can optionally use a Quick Ping preset.

POST to it

Wire the URL into a connected system. Send a title and message, or fire it empty and use the webhook's saved defaults.

The room fires

PingRoom sends the update to the room's recipients. Arrival depends on their devices, connectivity, and notification settings.

One request. One Ping.

Send title, message, and an action number from 1 to 16 to use a Quick Ping preset, or omit the fields and use the webhook’s saved defaults. Set action to null to bypass a saved preset.

# Fire a room. The secret in the URL is the credential, no auth header.
curl -sX POST https://api.pingroom.io/api/webhooks/ABC123/whk_9f3c…e1 \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Build passed",
    "message": "main is green ✅",
    "action": 1
  }'

Full field reference, signing, cooldowns, and error codes live in the webhook docs.

Up to four per room

Give CI, billing, and a form backend their own URLs and revoke any one without touching the rest. Quick Ping presets are optional; the four-webhook limit is separate from Pro's 16 Quick Ping slots.

The URL is the credential

Each webhook carries a secret in its path. Anything holding the URL can fire the room, so treat it like a password.

Part of Pro

Incoming webhooks come with PingRoom Pro, alongside outgoing webhooks, up to 100 scheduled triggers and up to 5 location triggers in every room.

Good for

CI build finishedPayment receivedServer alertForm submissionCron job doneIoT button press

Wire your stack to a room.

Download PingRoom, create a room, copy the webhook URL. Done.

Download the app