Developer APIWhatsTask Direct
Notifications API
Send Telegram notifications from your app with a single API call. No auth tokens. No webhooks to configure. Just POST and go.
POST /api/notifications/send
curl -X POST https://pm.whatstask.com/api/notifications/send \
-H "Content-Type: application/json" \
-d '{
"telegramId": "YOUR_ID",
"message": "<b>New order</b> #1042",
"type": "general"
}'One endpoint
A single POST request.
No auth needed
Just your Telegram ID.
HTML support
Rich text formatting.
Endpoint
The request.
Base URL: https://pm.whatstask.com/api/notifications/send
| Field | Required | Description |
|---|---|---|
| telegramId | Yes | Your Telegram ID, from @whatstask_bot |
| message | Yes | Notification text — HTML supported |
| type | No | Notification type — defaults to general |
Code examples
In your language.
Copy-paste examples for popular languages.
curl -X POST "https://pm.whatstask.com/api/notifications/send" \
-H "Content-Type: application/json" \
-d '{
"telegramId": "YOUR_TELEGRAM_ID",
"message": "<b>Alert</b>\n\nSomething happened!",
"type": "general"
}'Formatting
Supported tags.
| Tag | Result |
|---|---|
| <b> | bold |
| <i> | italic |
| <code> | monospace |
| <pre> | code block |
| <a href> | link |
| \n | newline |
Templates
Ready-to-use messages.
E-commerce order
New order notifications.
message
const message = `<b>🛒 New Order</b>
Order #${orderId}
Customer: ${customerName}
Total: <b>$${total}</b>
<a href="https://dashboard.example.com/orders/${orderId}">View Order</a>`Server monitoring
System alerts.
message
const message = `<b>⚠️ Server Alert</b>
Server: ${serverName}
Issue: ${alertType}
Time: ${timestamp}
CPU: ${cpuUsage}%
Memory: ${memUsage}%`Form submission
Contact form alerts.
message
const message = `<b>📬 New Contact</b>
From: ${name}
Email: ${email}
<i>"${messageText.slice(0, 200)}"</i>`Deployment status
CI/CD notifications.
message
const message = `<b>🚀 Deployment ${status}</b>
Project: ${projectName}
Branch: ${branch}
Commit: <code>${commitHash.slice(0, 7)}</code>
${status === 'success' ? '✅ Live now' : '❌ Check logs'}`Responses
Response codes.
| Status | Meaning | Fix |
|---|---|---|
| 200 | Notification sent | — |
| 400 | Missing telegramId or message | Include both fields in the request body. |
| 500 | Bot not configured or Telegram API error | Check your Telegram ID and that you’ve started @whatstask_bot. |
Pricing
Free, Pro and Business.
The Developer API is priced on its own. Pro and Business are paid monthly in Telegram Stars.
Free
0free
For testing & small projects
- 1,000 webhooks/month
- 1 API key
- Basic support
Pro
200 Starsper month
For production apps
- 10,000 webhooks/month
- 5 API keys
- Priority support
- Webhook logs
Business
500 Starsper month
High-volume needs
- 100,000 webhooks/month
- Unlimited API keys
- Dedicated support
- Custom SLA