Telegram Notifications API

Send notifications to Telegram chats, channels, and groups through a simple REST API.

Base URL https://notifications.aow.space

Send Notification

POST / Send a message to one or more Telegram chats

Headers

Content-Type : application/json

Request Body

message	string	required	The message text to send to receivers
receivers	int[]	required	Array of Telegram chat IDs (channels, private chats, or groups)

Example Request

                                JSON
                            

{
  "message": "Test message",
  "receivers": [123456789, 987654321]
}
                            

cURL Example click values to edit, then hit Send

bash

curl -X POST https://notifications.aow.space/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Test message",
    "receivers": [123456789, 987654321]
  }'

Notify via Webhook

POST /notify/{token} Send a message to the chat this link is scoped to

Headers

Content-Type : application/json

Request Body

message	string	required	The message text to send
receivers	int[]	optional	Additional chat IDs to also notify, beyond the one this link is scoped to
parse_mode	string	optional	Telegram parse mode for the message (e.g. Markdown, HTML)
title	string	optional	Optional title shown above the message
disable_notification	bool	optional	Send the message silently

{token} is obtained via the bot's /webhook command and is scoped to one chat.

Example Request

                                bash
                            

curl -X POST https://notifications.aow.space/notify/123456789.a1b2c3d4e5f6... \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Test message"
  }'
                            

Telegram Bot

🤖

@notificationsbotbot

Add the bot to your chat to get started. Open in Telegram

📄

Get your Chat ID

Use the /chatid command in any chat where the bot is present to obtain the chat ID for the receivers parameter.

🔗

Get a Webhook Link

Use the /webhook command in any chat to get a signed link for sending notifications there directly, without needing this API's normal request format's receivers field.