Webhook

The Webhook tab in Settings connects a custom webhookCustom webhookYour own HTTPS endpoint, set on the Webhook tab in Settings. Alertified sends each alert to it as a JSON POST request, for your own systems to process. Read more → : an HTTPS address on your own server, or on a tool that accepts webhooks. Alerts that use the Webhook channelChannelA place Alertified sends notifications: Email, Telegram, Discord, Slack, Microsoft Teams, Webhook or ntfy. You connect channels in Settings and choose for each alert which ones it uses. Read more → send their details there as JSON, so your own systems can act on them.

Set your endpoint

1. Open Settings → Webhook.
2. Under Enter your Webhook URL, enter your endpoint. It must start with https://.
3. Click Connect.

The tab shows “Webhook connected successfully!”, the badge changes to Connected, and the box Webhook connected shows Active. Your shop has one custom webhook. To change the address, click Disconnect, then connect the new one.

Use a hard-to-guess URL

Alertified does not sign its requests or add an authorization header. Your endpoint recognizes Alertified’s requests by their URL. Put a long random token in the path or the query string, and have your endpoint check it:

https://example.com/hooks/alertified/9f2c4e7a1b8d4f03a6e5
https://example.com/hooks/alertified?token=9f2c4e7a1b8d4f03a6e5

Caution

Treat the full URL like a password. Anyone who has it can send requests that look like Alertified’s.

Test the endpoint

Click Send Test Message. Alertified sends a request with the event test straight away, and the tab shows “Test message sent to your webhook!” when your endpoint answers with a 2xx status. If it answers anything else, the tab shows the status and what to check. See Testing a channel.

What Alertified sends

For each alert, Alertified sends one request:

• Method POST to your URL.
• Header Content-Type: application/json.
• A JSON body for one alert. The event low_stock_alert carries the product, variant, location, current stock and threshold.

The fields and full examples are in the webhook payload reference.

What counts as delivered

Any 2xx status (200, 201, 202, 204 and so on) counts as delivered and shows as Sent in Logs → Notifications under the Webhook channel. Any other status, or no answer, shows as Failed, with the status and your endpoint’s answer when you hover over the badge.

Disconnect

Click Disconnect on the Webhook tab. The tab shows “Webhook disconnected.” and Alertified stops sending to the address.

See also

• Webhook payloads — every field Alertified sends, with JSON examples.
• Testing a channel — what a failed test means.
• Logs — every webhook request Alertified sent, with its status.

Last updated: 14 November 2026