5-Minute Quickstart

This tutorial walks through sending your first transactional email notification using GNS in under five minutes.

Step 1: Obtain Application Credentials

1. Log in to the GNS Console.
2. Navigate to Applications and click + App (or select your existing application).
3. Under Credentials, generate a new Application Key.
4. Save the secret token immediately (e.g. gns_live_sk_9d8f7e6a5b4c3d2e1f0a).

[!NOTE] GNS Application Keys use the format gns_live_sk_<token>. For security, secret keys are shown once upon creation and cannot be retrieved later.

Step 2: Send Your First Notification

Make a POST request to /api/v1/notifications with your bearer token and message payload:

curl -X POST "https://api.gns.iitdeveloper.com/api/v1/notifications" \
-H "Authorization: Bearer gns_live_sk_9d8f7e6a5b4c3d2e1f0a" \
-H "Content-Type: application/json" \
-d '{
  "channel": "email",
  "recipient": "user@example.com",
  "subject": "Welcome to Our Platform!",
  "body": "Hello Alex,\n\nThank you for joining. Your account is now active.",
  "template_data": {
    "name": "Alex",
    "action_url": "https://example.com/dashboard"
  }
}'

Step 3: Verify the Response

Upon acceptance, GNS returns a 202 Accepted status with the persisted notification_id and tracking metadata:

{
  "status": "accepted",
  "notification_id": "notif_01J7K3X9AB0C1D2E3F4G5H6J7K",
  "channel": "email",
  "recipient": "u***r@example.com",
  "created_at": "2026-09-13T12:00:00.000Z",
  "delivery_status": "queued"
}

Step 4: Check Delivery in /activity

1. In the GNS Console, navigate to Activity.
2. Search for your notification_id or recipient.
3. Inspect the delivery timeline to see the SMTP handshake confirmation, recipient receipt, and delivery timestamps.