Webhook
Send each notification to a URL in the Prowl webhook format.
What it does
Posts your notifications to a URL you choose, as a JSON request.
Before you start
You need an endpoint reachable from the public internet which can answer 2xx to Prowl requests. It cannot be a private address, nor can it be behind an HTTP redirect.
If a firewall sits in front of your endpoint, Prowl sends from these addresses:
209.71.111.202a09:8280:e618:1:0:11f:5480:0
and uses the User-Agent:
Prowl/<version> (+https://www.prowl.app/)
Set it up
Paste your endpoint into "Endpoint URL". Prowl doesn't contact it when you save, so a URL that points at nothing is still added.
Check it works
Choose "Test webhook" to send a test notification. Every test notification shares the same identifier, so an endpoint that discards repeats will ignore every test after the first.
The result shows the exact request headers and body Prowl sent and the status your endpoint returned. A test never pauses the Destination.
Choose "Pretty" in the test dialog to make the body easier to read. The plain version is the exact bytes Prowl sent and signed.
Options and behavior
What Prowl sends
A POST with content-type: application/json. The body is a CloudEvents envelope whose data is the same shape the Prowl API accepts:
{
"specversion": "1.0",
"type": "prowl.notification",
"id": "msg_…",
"source": "https://www.prowl.app",
"time": "2026-01-01T12:00:00Z",
"max_forwards": 2,
"data": {
"application": "Example",
"event": "Build finished",
"description": "All tests passed",
"url": "https://example.com/builds/1",
"priority": "normal"
}
}
| Field | Notes |
|---|---|
id |
Identifies the notification, and stays the same if Prowl retries it |
priority |
one of very_low, moderate, normal, high, or emergency |
description |
May be null |
url |
May be null |
time |
When the notification was created. Retries have the same time. |
max_forwards |
A Prowl-specific extension to avoid event loops. Decrement if you forward too. |
Verifying the signature
Prowl signs every request with Standard Webhooks headers. Verify it with any Standard Webhooks library. You'll find your "Signing secret" on the Destination's page.
Retries and repeats
Prowl will wait about 10 seconds for a response, and expects 2xx for success. A 404 or 410 stops delivery straight away. A 4xx other than those is discarded after one attempt. Anything else, including a redirect, is tried again for up to about two hours before giving up.
The webhook-id header and id body field can be used as an idempotency key to avoid duplicates. The body time field is static for the notification, but the webhook-timestamp header is the request attempt time.
Notifications can arrive out of order, since a retried one can follow notifications sent after it. Order by the body's time rather than by when it arrived.
Troubleshooting
The Destination needs attention
If your endpoint returns 404 or 410, Prowl will pause the Destination and mark it as "Needs attention". Choose "Reconfigure" to update it; your routing and minimum priority are kept.
Notifications stop arriving, but nothing looks wrong
A response other than 2xx, 404, or 410 fails without telling you. Check for:
- A 401, 403, or 422 response
- Payload parsing errors
- A redirect in front of your endpoint, which Prowl retries rather than follows
- A hostname that stopped resolving, or that now resolves to a private address
- An expired or self-signed certificate
- A response that takes longer than Prowl waits
Choose "Test webhook" from the Destination's page to get a better idea of what is happening.
The signature doesn't verify
Compare what you received against the plain body in the test result, which is exactly what Prowl signed.
Disconnect or replace it
To send somewhere else, edit "Endpoint URL" and choose "Save". Your routing, minimum priority, and signing secret are kept.
Choose "Rotate" to replace the signing secret. The old one stops working immediately, including for notifications Prowl is still retrying, so add the new secret to your endpoint first.
Remove the Destination to stop sending.