Telegram Notifier - API Documentation & Playground

API Documentation

Send Message Endpoint

POST /send

Send a message to a Telegram chat using the configured bot.

Example Requests

cURL

curl -X POST http://localhost:3000/send \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from Telegram Notifier!"}'

JavaScript (Fetch)

fetch('http://localhost:3000/send', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        message: 'Hello from Telegram Notifier!'
    })
})
.then(response => response.json())
.then(data => console.log(data));

Python (Requests)

import requests

response = requests.post('http://localhost:3000/send', 
    json={'message': 'Hello from Telegram Notifier!'})
    
print(response.json())

Response Format

Success Response

{
    "success": true,
    "data": null,
    "message": "Message sent successfully"
}

Error Response

{
    "success": false,
    "message": "Error description"
}

Test Playground

Test the API with your own Telegram bot credentials

🔒 Privacy Notice: Your bot token and chat ID are never saved or logged. All requests are processed in memory only and discarded immediately after use. This playground is completely safe to use.