Send Manual Notification

POST

http://localhost:8080/api/v3/notifications

POST

/api/v3/notifications

curl -X POST http://localhost:8080/api/v3/notifications \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "X-Device-Id: {{deviceId}}" \
     -H "X-Request-Id: {{requestId}}" \
     -H "X-Signature: {{signature}}" \
     -H "X-Timestamp: {{timestamp}}" \
     -H "Content-Type: application/json" \
     -d '{
  "moduleName": "wallet",
  "channel": "SMS",
  "recipients": [
    {
      "identifier": "254712345678",
      "message": "Your OTP is 123456"
    }
  ],
  "title": "OTP Code",
  "templateKey": "otp_sms",
  "variables": {
    "otp": "123456"
  },
  "entityType": "WALLET",
  "entityId": "b1e7f6a0-9d2b-4a5b-9c3d-1a2b3c4d5e6f",
  "idempotencyKey": "notif-2026-09-17-001"
}'

200Notifications_sendManualNotification_example

{
  "code": 200,
  "message": "Notifications published successfully",
  "data": [
    {
      "notificationId": "notif-1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5f",
      "outboxId": "outbox-2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
      "created": true
    }
  ]
}

Headers

Request

This endpoint expects an object.

moduleNamestringOptional

channelstringOptional

recipientslist of objectsOptional

titlestringOptional

templateKeystringOptional

variablesobjectOptional

entityTypestringOptional

entityIdstringOptional

idempotencyKeystringOptional

Response

200 OK

codeintegerOptional

messagestringOptional

datalist of objectsOptional