Documentation

Quick Start

Send your first notification in seconds. No signup required for public topics.

# Just send a POST request

curl -d "Hello from my Pi!" iotpush.com/api/push/my-topic

API Reference

Send Notification

POST /api/push/{topic}

Request Body

Plain text or JSON message

Optional Headers

Header	Description	Example
Title	Notification title	Alert!
Priority	low, normal, high, urgent	high
Tags	Comma-separated tags	warning,sensor
Click	URL to open on click	https://...

Examples

Simple message:

curl -d "Sensor triggered!" iotpush.com/api/push/my-topic

With title and priority:

curl -H "Title: Alert" -H "Priority: high" \

-d "Temperature exceeded 80°C" \

iotpush.com/api/push/my-topic

JSON body:

curl -H "Content-Type: application/json" \

-d ''{"title":"Alert","message":"Temp high!","priority":"high"}'' \

iotpush.com/api/push/my-topic

Language Examples

Python

import requests

requests.post(
    "https://iotpush.com/api/push/my-topic",
    data="Hello from Python!",
    headers={"Title": "Python Alert"}
)

JavaScript / Node.js

fetch("https://iotpush.com/api/push/my-topic", {
  method: "POST",
  body: "Hello from JS!",
  headers: { "Title": "JS Alert" }
});

Arduino / ESP32

#include <HTTPClient.h>

HTTPClient http;
http.begin("https://iotpush.com/api/push/my-topic");
http.addHeader("Title", "ESP32 Alert");
http.POST("Sensor value: " + String(sensorValue));
http.end();

Rate Limits

Plan	Messages/Day	Topics
Free	100	3
Pro ($9/mo)	10,000	Unlimited
Business ($49/mo)	Unlimited	Unlimited