Static webhook
Last updatedยท1 min read
Receive a push notification whenever an external service sends a webhook. The entire JSON payload is formatted into a readable notification body automatically.
Use this when you just want to know something happened and don't need to extract specific fields from the payload.
Endpoint
POST https://thenotification.app/api/webhook/static/
Query parameters
| Parameter | Required | Description |
|---|---|---|
| app_key | Yes | Your application API key |
| title | No | Notification title. Defaults to "Webhook Notification". URL-encode spaces. |
Example URL
https://thenotification.app/api/webhook/static/?app_key=YOUR_API_KEY&title=Coolify%20Deployment
Paste this URL into the webhook field of any service that supports webhooks.
How it works
- The external service sends a POST request with a JSON payload to your webhook URL
- Your
app_keyis validated from the query parameter - The JSON payload is formatted into readable text
- A notification is sent to all your registered devices
Response
{
"success": true,
"message": "Notification sent to 1 device(s)",
"devices_sent": 1,
"failed_count": 0
}
Coolify setup
In Coolify, go to Settings โ Notifications โ Webhook and paste your webhook URL:
https://thenotification.app/api/webhook/static/?app_key=YOUR_API_KEY&title=Coolify%20Deployment
You'll get a notification every time an app deploys, fails, or restarts.
When to use static vs dynamic
Use the static webhook when:
- You just need to know the event happened
- You don't need to extract specific fields from the payload
- The full payload as a notification body is fine
Use the dynamic webhook when:
- You want the notification title or body to come from a specific field in the payload
- You want to exclude noisy fields from the notification