# iotPush API

**Canonical:** https://apis.io/apis/iotpush-com/iotpush-com-api/  
**Provider:** iotPush — https://apis.io/providers/iotpush-com/  
**Base URL:** https://iotpush.com  
**Documentation:** https://www.iotpush.com/docs

iotPush API is published by [iotPush](https://apis.io/providers/iotpush-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

iotPush API as documented publicly: 25 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | GET / |
| POST | `/api/1/messages.json` | Pushover‑compatible endpoint |
| POST | `/api/action` | Report Action |
| GET | `/api/devices` | List devices |
| POST | `/api/devices` | Register a device |
| GET | `/api/push/{topic}` | GET /api/push/{topic} |
| POST | `/api/push/{topic}` | Send a push notification to all subscribers of a topic. |
| POST | `/api/pushover` | Pushover‑compatible endpoint (alternative URL) |
| GET | `/api/receipts` | List receipts |
| GET | `/api/receipts/{receiptId}` | Get a receipt |
| GET | `/api/topics` | List all your topics |
| POST | `/api/topics` | Create a new topic |
| DELETE | `/api/topics/{id}` | Delete a topic and all its messages |
| PATCH | `/api/topics/{id}` | Update topic name, description, or privacy |
| GET | `/api/v1/links` | List links |
| POST | `/api/v1/links` | Link a resource → a topic, phones already subscribed |
| DELETE | `/api/v1/links/{id}` | Unlinks (the topic stays) |
| POST | `/api/v1/questions` | POST /api/v1/questions with question , and optionally title , kind , topic , timeout_s (10–86400, default 300) and idempotency_key . Returns question_id . |
| POST | `/api/v1/questions/{questionId}/cancel` | POST /api/v1/questions/{question_id}/cancel withdraws it. |
| GET | `/api/v1/questions/{questionId}/wait` | GET /api/v1/questions/{question_id}/wait?timeout=30 (up to 55 s). Repeat while status is pending . |
| GET | `/api/webhooks` | List all your webhooks |
| POST | `/api/webhooks` | Create a webhook |
| DELETE | `/api/webhooks/{id}` | Delete a webhook |
| PATCH | `/api/webhooks/{id}` | Update url, events, active, or topic_ids |
| POST | `/api/webhooks/{id}/test` | Send a test event to the webhook URL |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/iotpush-com/openapi/_ae-authored/iotpush-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-post-api-push-topic-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-post-api1-messages-json-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-post-api-pushover-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-post-api-action-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-post-api-devices-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iotpush-com/json-schema/iotpush-com-get-api-receipts-receiptid-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/iotpush-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/iotpush-com/iotpush-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/iotpush-com/.