Documentation Menu
DocsAPI ReferenceUnified Notification API Reference

Unified Notification API Reference

Complete REST API endpoints for dispatching, status queries, and template updates.

# Unified API Reference

NotifySetu provides a clean, idempotent REST API. All requests accept JSON payloads and return ISO 8601 timestamps.

POST /v1/notifications/send

Dispatch a notification across one or more configured channels.

### Request Body Schema

| Field | Type | Required | Description | |---|---|---|---| | `recipient` | string | Yes | Target email address or E.164 formatted phone number. | | `channels` | array[string] | Yes | `EMAIL`, `SMS`, `WHATSAPP`, `PUSH`, `VOICE`, `OTP` | | `templateId` | string | Yes | Unique ID of stored Handlebars template. | | `variables` | object | No | Key-value dictionary for template substitution. | | `routingPolicy` | object | No | Smart fallback strategy parameters. |

GET /v1/notifications/{id}

Retrieve real-time delivery status, provider latency, and log history for a specific notification.