FAQ & Troubleshooting

API error codes

Status	Cause	Fix
400	Malformed JSON, missing message, or invalid level.	Check the body against the Push API.
401	Missing, wrong or revoked token.	Send Authorization: Bearer <key>. Create a new token if revoked.
403	Account suspended.	Contact an administrator.
429	More than 60 requests per minute on one token.	Wait for Retry-After seconds, and batch your events.
500	Unexpected error.	Retry; contact support if it persists.

Rate limits

• Push API: 60 requests per minute per token (configurable by the server operator).
• Email codes: one per 60 seconds, five per hour.
• Test buttons: five per minute.

I pushed a notification but got nothing in Telegram or email

1. Open Notifications. If the entry exists, the API call worked.
2. Check the delivery badge:
   • No recipient: no active channel. Connect one on the Channels page.
   • Failed: the provider rejected the message. Use the test button on the Channels page.
3. For Telegram, make sure you have not blocked the bot or sent /stop.
4. For email, check your spam folder and that the channel is not turned off.

The verification code never arrives

• Check spam, and confirm the address has no typo.
• Wait 60 seconds before requesting another code.
• Codes expire after 10 minutes. Request a fresh one if yours is older.

My site shows DOWN but it works in my browser

• The expected status code may differ (for example your site returns 301 or 403 to bots).
• The keyword may not appear in the response.
• The timeout may be too low for a slow page.
• A firewall or WAF may block our requests. Allow the NotificationManager-UptimeChecker/1.0 user agent.

I did not get a down alert

• The failure threshold may not have been reached yet.
• Your cooldown may have suppressed it.
• It may have fallen inside your mute schedule (it still appears in the feed as Muted).

Why can't I add localhost?

Private and loopback addresses are blocked to prevent the server from probing internal networks.