Dispatch
Docs/API Reference

API Reference

Base URL: https://api.dispatch.wejoona.com

Auth: Bearer tokenFormat: JSONRate limit: 1000 req/min
POST/v1/send

Send a notification to one or more channels.

Request

{
  "to": "user_abc123",
  "template": "payment-received",
  "channels": ["email", "sms", "push"],
  "data": {
    "amount": "25,000 XOF",
    "sender": "Moussa K.",
    "ref": "TXN-8291"
  }
}

Response

{
  "notification_id": "ntf_9k2m8x",
  "status": "dispatched",
  "channels": {
    "email": { "status": "delivered", "provider": "postal", "latency_ms": 89 },
    "sms": { "status": "delivered", "provider": "pushly", "latency_ms": 142 },
    "push": { "status": "delivered", "provider": "fcm", "latency_ms": 67 }
  }
}
POST/v1/send/batch

Send to multiple recipients in one call (up to 10K).

Request

{
  "template": "promo-offer",
  "channels": ["sms"],
  "recipients": [
    { "to": "user_001", "data": { "name": "Awa" } },
    { "to": "user_002", "data": { "name": "Kofi" } }
  ]
}

Response

{
  "batch_id": "btc_7x3m",
  "total": 2,
  "queued": 2,
  "status": "processing"
}
GET/v1/notifications/:id

Get status of a sent notification.

Response

{
  "notification_id": "ntf_9k2m8x",
  "template": "payment-received",
  "to": "user_abc123",
  "channels": {
    "email": { "status": "opened", "opened_at": "2026-02-21T18:45:00Z" },
    "sms": { "status": "delivered" },
    "push": { "status": "delivered" }
  },
  "created_at": "2026-02-21T18:30:00Z"
}
POST/v1/templates

Create a notification template.

Request

{
  "name": "payment-received",
  "channels": {
    "email": {
      "subject": "Payment received: {{amount}}",
      "html": "<h1>Hi {{name}},</h1><p>You received {{amount}} from {{sender}}.</p>"
    },
    "sms": {
      "body": "You received {{amount}} from {{sender}}. Ref: {{ref}}"
    },
    "push": {
      "title": "Payment received",
      "body": "{{amount}} from {{sender}}"
    }
  }
}

Response

{
  "template_id": "tpl_pay_recv",
  "name": "payment-received",
  "version": 1,
  "channels": ["email", "sms", "push"],
  "created_at": "2026-02-21T18:00:00Z"
}