SMS Gateway API: Built for Developers
The GenioSms API allows you to programmatically send messages directly from your website, CRM, or backend application. By leveraging your connected Android devices as low-cost transmission gateways, you can achieve high-volume delivery without the premium costs of traditional global providers.
Key Integration Features
● Instant API Key Generation: Create and manage your secure keys directly from the control panel.
● Ready-to-Use Code Samples: Access implementation examples in PHP, Python, Perl, and cURL via the "CODE" button in your dashboard.
● Multi-Device Scalability: Connect an unlimited number of smartphones. Our system automatically load-balances requests, routing each SMS to the first available device for maximum throughput.
● JSON Responses: Receive structured data for every request, allowing for seamless parsing and error handling in your application.
Primary Use Cases
● OTP & 2FA: Send One-Time Passwords for secure user registration and verification.
● IoT & Automation: Trigger SMS alerts for smart home systems, server monitors, or industrial sensors.
● Order Notifications: Automate real-time updates for e-commerce shipping and delivery status.
Real-Time Tracking with IPN (Webhooks)
The GenioSms IPN (Instant Process Notification) is a powerful callback system that sends a POST request to your server whenever a message status changes. This ensures your database stays in sync with the actual delivery lifecycle.
How IPN Works
1. Configure your Endpoint: Enter the URL of the script on your server that will process the notifications.
2. Select Events: Choose to monitor "Sent" (SMS left the device) or "Delivered" (Handshake confirmation from the recipient's carrier).
3. Automatic Callbacks: When an event occurs, our server pushes the data to your URL instantly.
Why Professional Devs Use IPN
● Reliability: Unlike client-side redirects, IPN works server-to-server. It triggers even if the user is offline or has closed their browser.
● Backend Automation: Automatically update user profiles, trigger follow-up emails, or log delivery timestamps in your SQL/NoSQL databases.
● Full Lifecycle Visibility: Gain a 360-degree view of your message flow, from the initial API call to the final carrier delivery report.
Developer Notes & Best Practices
● Status Codes: For a full breakdown of `status_code` values (e.g., IP authorization, rate limits), please refer to the Complete API Documentation.
● Security: Use our "IP Whitelisting" feature to ensure that only your authorized servers can trigger SMS sends.
● Current Scope: IPN notifications are currently active for all API-driven messaging. Future updates will expand this to include CRM campaigns and Surveys.
