How NotifyHub works
One API, three delivery channels. Here's the whole picture — from getting your key to what the person receiving the message actually sees.
Getting started
1. Create an account
Sign up with an email and password — you get a live API key immediately, no approval wait.
2. Find your API key
It's shown on your dashboard right after signup, and any time after that. You can rotate it if it ever leaks.
3. Send a notification
Call
POST /api/v1/notifywith a channel, a recipient, and a message. See the exact request below.
What each channel actually needs
The tricky part isn't the API call — it's getting the right "recipient" value for each channel. Here's what that looks like for the person on the other end.
No setup needed on the recipient's side. Just use their phone number in international format (e.g. +15551234567) as the to field — the message arrives from the WhatsApp number linked to this NotifyHub account.
Telegram
This one needs a one-time step from the recipient before you can message them:
- They open Telegram and message this platform's bot (any message, or just "/start")
- The bot replies instantly with their personal chat ID, e.g. "Your Telegram chat ID is: 123456789"
- They send you that chat ID — you use it as the
tofield from then on
That's it — no re-verification needed after the first time. It's the same one-time step CallMeBot's own Telegram channel uses.
SMS
Also no setup needed — just their phone number in international format as the to field. Delivered via Africa's Talking.
POST /api/v1/notify
{
"channel": "whatsapp",
"to": "+15551234567",
"title": "Order #1024",
"message": "Your order has shipped"
}Authenticate with Authorization: Bearer sk_live_... — find your key on the dashboard.
Channel values
"whatsapp"
Recipient is a phone number in international format, e.g. "+15551234567".
"telegram"
Recipient is the numeric chat ID a user gets after messaging your bot.
"sms"
Recipient is a phone number in international format, e.g. "+15551234567".
GET /api/v1/history
Returns your most recent notifications with their delivery status, newest first.