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. Include multiple objects in the notifications array, where each object has its own content and its own 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 treats the notifications array as a batch. Dispatch workers process the items in parallel and hand them to the push gateways (APNs, FCM).

Limits and batching

• Each notification object can target up to 1,000 User IDs in its users field (the same limit applies to devices).
• Non-enterprise accounts can make up to 600 /createMessage and/or /createTargetedMessage requests per minute. Contact support if you need a higher rate.
• Keep individual requests reasonably small and split very large audiences across several requests. If you need a guaranteed maximum for the number of objects in one notifications array or for the request body size, ask Pushwoosh support — these are not published limits.
• Use transactionId to protect against duplicates on retry. Pushwoosh stores this identifier for 5 minutes, so a retry sent within that window is ignored; a retry sent later is treated as a new message.