Websites
GET /sites returns the account-owned numeric site IDs required by campaign calls.
The versioned API uses account bearer tokens and the same ownership, destination, audience, allowance, and scheduling checks as the dashboard. It can create drafts or schedules, but it cannot grant browser permission.
Generate a token in API & MCP settings, store it outside source control, and send it only in the Authorization header. The token is displayed once and stored as a one-way hash.
curl --fail-with-body \
-H "Authorization: Bearer $PUSHNOTIFICATIONS_TOKEN" \
https://pushnotifications.org/api/v1/sitesGET /sites returns the account-owned numeric site IDs required by campaign calls.
GET /overview returns delivery usage, campaign totals, and the next scheduled campaign.
GET /campaigns lists work; POST /campaigns creates a draft or validated schedule.
GET or PATCH /campaigns/{id} reviews or edits an account-owned draft or schedule.
Start with status: draft. Use a site ID returned by /sites, keep the destination on that verified website, and review the result before scheduling.
{
"site_id": 42,
"title": "The November guide is ready",
"body": "Read the new guide and save the checklist.",
"target_url": "https://example.com/guides/november",
"status": "draft",
"targeting": {
"devices": ["desktop", "phone"],
"browsers": ["chrome", "safari"]
}
}An optional public HTTPS image and up to two action buttons can be included. Browser and operating-system support varies; the title, message, and main destination remain the fallback.
{
"image_url": "https://example.com/images/guide.webp",
"actions": [
{"label": "Read guide", "url": "https://example.com/guides/november"},
{"label": "View checklist", "url": "https://example.com/checklist"}
]
}See the MCP server for typed AI-client tools or use the command-line client for terminal workflows.