ComRaid
PUSH NOTIFICATION API

Push notification API

Trigger Android and iOS FCM push from your backend. ComRaid handles contacts, fan-out, queues, and delivery records so product code stays on business logic.

A modern push notification API should feel like any other infrastructure dependency: authenticate, create a Message, move on.

POST /messages
curl https://api.comraid.app/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "push",
    "to": { "external_user_ids": ["customer_123"] },
    "content": {
      "push": {
        "title": "Something good just landed",
        "body": "Your next favorite feature is here.",
        "platforms": ["android", "ios"]
      }
    }
  }'

Core resources

Contacts & Endpoints
Register people and their push Endpoints (FCM/APNs device tokens) for Android and iOS.
Messages & Notifications
Single send and Broadcast via /messages; Multi-send via /campaigns. On the push Channel the dashboard and docs call them Notifications.
Segments
Target audiences from attributes your product supplies.
Delivery visibility
Inspect outcomes on the notification—same model the dashboard uses.

Your backend stays in charge

Your app

Chooses when someone should hear from you and what the message means for the business.

ComRaid

Queues work, talks to FCM, retries, and keeps delivery records—plus attribution IDs for conversions you measure.

Docs at docs.comraid.app. API base https://api.comraid.app. Also see FCM push.

FAQ

Good questions.
Clear answers.

How do I authenticate to the API?

Use a project API key with the Authorization: Bearer header. The key resolves exactly one project—do not trust a caller-supplied project_id over authenticated project context.

Can I schedule sends from the API?

Yes. Create Messages (Notifications on the push Channel) to send immediately or schedule them for later. Single send and Broadcast use POST /messages; Multi-send uses POST /campaigns. The dashboard exposes the same model for teams that prefer a UI.

Where do I inspect delivery results?

Inspect sent, delivered, skipped and failed outcomes on Notification detail or through the API. Device ACK sets delivered; Provider acceptance alone is sent, not delivered.

BUILD WITH THE API

Trigger push
from your backend.

Create an API key, register Contacts, and POST your first Message.

Create your workspace