Quickstart & First Notification

# Quickstart Guide

Welcome to NotifySetu! This guide will take you from zero to sending your first multi-channel notification across Email, SMS, or WhatsApp.

Prerequisites

Before starting, ensure you have: 1. Created an account at [notifysetu.com](https://notifysetu.com). 2. Generated your Live or Test API Key from **Settings -> API Keys**.

Get your API Key

API keys use the standard bearer token format: - Test mode: `nts_test_...` - Live mode: `nts_live_...`

Keep your API keys confidential. Do not expose live keys in client-side applications.

Dispatch First Payload

Run the following cURL request in your terminal to dispatch a test notification:

curl -X POST https://api.notifysetu.com/api/v1/notifications/send \
  -H "Authorization: Bearer nts_test_sample_key" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "user@example.com",
    "channels": ["EMAIL", "SMS"],
    "templateId": "tmpl_welcome",
    "variables": {
      "name": "Alex"
    }
  }'

Verify Delivery Status

The API returns a unique `notificationId` immediately:

{
  "notificationId": "ntf_live_01m18gep0",
  "status": "QUEUED",
  "channels": ["EMAIL", "SMS"],
  "queuedAt": "2026-08-30T12:00:00Z"
}