Quickstart & First Notification
Send your first unified notification in under 5 minutes using cURL or SDKs.
# 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 a free account at [console.notifysetu.com](https://console.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/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:
{
"status": "SUCCESS",
"notificationId": "nts_msg_98a72b1c",
"channelStatuses": [
{ "channel": "EMAIL", "provider": "SES", "status": "DELIVERED" },
{ "channel": "SMS", "provider": "TWILIO", "status": "DELIVERED" }
]
}