Send bulk push notifications

POST

/push/send-bulk

POST

/notification/push/send-bulk

const url = 'https://api.etera.dev/notification/push/send-bulk';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"notifications":[{"tokens":["string"],"title":"string","body":"string"}]}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

200Successful

{
  "success": true,
  "data": {
    "success": true,
    "successCount": 1.1,
    "failureCount": 1.1,
    "results": [
      {
        "success": true,
        "messageId": "string",
        "error": "string",
        "failedTokens": [
          "string"
        ]
      }
    ]
  },
  "error": {
    "message": "string",
    "code": "string"
  }
}

Send multiple push notifications in a single request.

Features:

Batch processing of up to 500 notifications
Individual success/failure tracking per notification
Optimized for high-volume scenarios
Detailed response with per-notification results

Use Cases:

Marketing campaigns
Batch user notifications
Event-based messaging
Scheduled notifications

Limits:

Maximum 500 notifications per request
Each notification can target multiple tokens
Rate limiting applies per authenticated user

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Request

This endpoint expects an object.

notificationslist of objectsRequired

Response

This endpoint returns an object.

successboolean

dataobjectOptional

errorobjectOptional