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 actionnumber — 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 unlock with PingRoom Pro — alongside location and scheduled triggers and outgoing webhooks.
Good for
Wire your stack to a room.
Download PingRoom, create a room, copy the webhook URL. Done.
Download the app