GenioSms Gateway API Integration
From the control panel , you can generate your API keys to use with your website or application.
The API allows you to send messages directly from your scripts, the actual sending is performed by your mobile devices , which act as transmission gateways.
The control panel includes code examples in various programming languages.
A common use case is sending OTP codes to customers registering on your site to verify their phone numbers.
The APIs can also be used in automation or IoT (smart home) scenarios.
This section is designed for developers with basic web programming knowledge .
For those seeking a ready-to-use solution , the GenioSms platform offers a complete CRM environment for managing campaigns.
If you have specific integration needs , you can send message directly from your scripts using the provided APIs.
The API also includes an IPN (Instant Process Notification) system, which notifies a script on your server whenever an message changes status (sent, delivered, etc.).
As detailed in the API guides, integration is simple: in the table below, in the API column , you’ll find a CODE button that shows integration examples in various programming languages.
The GenioSms app can be installed on multiple devices to enable fast, large-scale message delivery .
There is no limit to the number of phones you can connect, each device is linked to a list via a PIN code .
When you send a message through the API, the request is distributed to all connected phones, but only the first available device will perform the actual sending.
The HTTP response , in JSON format , may contain multiple records, each representing the phone that received the request.
To track the actual status of the message (sent or delivered), use the IPN system :
when an SMS is sent or delivered to the recipient, the IPN automatically makes an HTTP callback to your script, allowing you to handle real-time delivery confirmations and updates.
The GenioSms IPN (Instant Process Notification) is an automatic notification service that sends a POST request to your server whenever a significant event occurs related to an message.
This mechanism allows you to automate backend processes and update databases reliably and securely, regardless of user actions.
How it works
To configure an IPN:
• Add a new IPN from the control panel.
• Select the branch and devices to be used, all devices associated with the same PIN as the selected one will be included.
• Enter the URL of the script on your server that will receive IPN notifications.
• Choose which events to monitor:
-> sent – triggered when the message is sent;
-> delivery – triggered when the SMS is delivered to the recipient’s phone.
Why it’s useful
• Backend automation – allows you to automate administrative functions such as real-time data updates on your servers.
For example, in an OTP verification flow, the script receiving the IPN can log the message status (sent or delivered) in the database. • Reliability – more reliable than user-based redirect mechanisms (like PDT), since the IPN works even if the user closes the browser or ends the session.
• User independence – IPN execution does not depend on user actions, ensuring that data is updated even if client-side interruptions occur.
• Comprehensive monitoring – provides notifications for different message-related events, giving you a full view of the message lifecycle.
In summary
The IPN is a powerful tool for businesses and developers who want to automate SMS-related processes and integrate them seamlessly into their server-side systems .
IPN Notes
Currently, IPN is active only for events related to SMS API operations .
Future updates may extend this functionality to other platform services.
Status_code notes:
For details about possible `status_code` values, please refer to the API Guide.
