Welcome to GNS

The Generic Notification Service (GNS) is a unified, high-performance omnichannel notification infrastructure engineered for enterprise reliability, multi-tenant isolation, and sub-second dispatch.

Whether your application needs to send critical authentication OTPs, bulk transactional emails, real-time in-app user notifications, or mission-critical outbound webhooks, GNS coordinates the delivery through resilient message brokers, dedicated connection pools, and automatic provider failover.

---

Architecture at a Glance

---

Core Capabilities

1. Omnichannel Dispatch

Send across multiple communication channels from a single API call:

• Email: Powered by Postal SMTP connection pooling, automatic SPF/DKIM verification, and dynamic sender handles.
• Transactional OTP: Cryptographically secure 4- or 6-digit codes, sliding-window rate limits, brute-force tombstoning, and client-supplied custom codes.
• In-App Notification Center: Real-time Server-Sent Events (SSE) and REST notification feed with live badge counters and read/unread synchronization.
• SMS & WhatsApp: Failover routing across Twilio and secondary regional providers.
• Outbound Webhooks: Guaranteed delivery receipts cryptographically signed with HMAC-SHA256 (X-GNS-Signature).

2. Two-Tier Quotas & Credit Leases

Applications belong to workspace plans with:

• Tier 1 (Included Monthly Quotas): Generous base allowances (e.g. 1,000 free OTPs/month) that automatically reset each billing cycle.
• Tier 2 (Commercial Credit Leasing): When included quotas are exhausted, GNS leases top-up balance credits from Central IAM in cached Redis blocks, ensuring zero hot-path database latency.

3. Complete Observability & Delivery Feed

Every outbound notification is server-persisted in the /activity feed. Integrators can inspect delivery timelines, investigate delivery errors, and trigger permission-gated delivery retries directly from the GNS Console.

---

Ready to build?

Continue to the 5-Minute Quickstart to dispatch your first notification.