Docs/Webhooks

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

  1. The external service sends a POST request with a JSON payload to your webhook URL
  2. Your app_key is validated from the query parameter
  3. The JSON payload is formatted into readable text
  4. 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