Inputs · Incoming webhooks
ProAny 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
Each room mints incoming webhooks, up to four, one per quick action, every one with its own secret baked into the URL.
POST to it
Wire the URL into any system. Send a title and message, or fire it empty and let the room's defaults fill in.
The room fires
The moment the request lands, everyone in the room feels it, under a second end to end.
One request. One Ping.
Send title, message, and an action number, or none of them, and the room’s defaults take over.
# 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
One webhook per quick action. Give CI, billing, and a form backend their own URLs and revoke any one without touching the rest.
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 location, schedule, and outgoing webhooks.
Good for
Wire your stack to a room.
Download PingRoom, create a room, copy the webhook URL. Done.
Download the app