How do I send personalized push notifications to multiple users in one API request?

Use the /createMessage endpoint to send unique messages to different users without using tags. You include multiple objects in the notifications array, where each object has its own text and target user IDs.

Example payload

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "YOUR_API_TOKEN",
    "notifications": [
      {
        "send_date": "now",
        "content": "Your event occurred at 22-Apr-2026 09:15:04 AM",
        "users": ["user_1"]
      },
      {
        "send_date": "now",
        "content": "Your event occurred at 22-Apr-2026 09:15:30 AM",
        "users": ["user_2"]
      }
    ]
  }
}

How it works

The system handles the notifications array as a batch. Dispatch workers process these items at the same time to send them to push gateways like APNs or FCM.

Limits and batching

Keep these constraints in mind when you send messages:

• A single notifications array can hold up to 1,000 notification objects.
• Each object can target up to 1,000 User IDs in its users field.
• The total size of your request body must stay under 10 MB.
• You can make up to 600 /createMessage requests every minute.

Use a transactionId in your request to prevent duplicate messages. If a request fails or times out, the system uses this ID to ignore retries of the same message.