Help Center

Find answers to common questions, browse documentation, and get the support you need.

Frequently Asked Questions

Quick answers to common questions

G Getting Started

How do I set up my first Android device?
Download the SMS Gateway app from Google Play or our GitHub releases, create an account, generate an API key in the dashboard, then scan the QR code in the app to connect your device. The app will guide you through granting necessary permissions.
What Android versions are supported?
SMS Gateway supports Android 6.0 (Marshmallow) and above. We recommend Android 8.0+ for the best experience and latest security features.
Can I use an old phone as a dedicated SMS device?
Absolutely! This is actually one of the most common use cases. Any Android phone with Android 6.0+ and an active SIM card will work perfectly.

A API & Integration

How do I send my first SMS via the API?
Make a POST request to /api/v1/sms/send with your API key in the X-API-Key header and a JSON body containing 'to' (phone number) and 'message' fields. Check our API documentation for detailed examples in multiple languages.
What's the rate limit for API requests?
Free tier: 100 requests/hour. Starter: 1,000/hour. Pro: 10,000/hour. Enterprise: Custom limits. Rate limits reset every hour and are tracked per API key.
How do webhooks work?
Configure a webhook URL in your device settings. We'll send POST requests to your URL for events like incoming messages, delivery confirmations, and status updates. All webhook payloads are signed for security.

D Devices & Connectivity

What happens if my device goes offline?
Messages are queued on our server and will be delivered once the device reconnects. You can configure multiple devices for redundancy, and we'll automatically route to available devices.
How many devices can I connect?
Free: 1 device. Starter: 1 device. Pro: 3 devices. Enterprise: Unlimited. You can upgrade your plan anytime to add more devices.
Do I need to disable battery optimization?
Yes, to ensure the app stays active in the background. The app will guide you through this during setup. This prevents Android from killing the foreground service.

B Billing & Plans

What happens when I reach my message limit?
You'll receive notifications at 80% and 100% usage. Messages will be queued but not sent until you upgrade or your monthly limit resets. No overage charges.
Can I upgrade or downgrade my plan anytime?
Yes! Upgrades are immediate. Downgrades take effect at the start of your next billing cycle. No penalties or fees for changing plans.
Do you offer refunds?
We offer a 14-day money-back guarantee on all paid plans. If you're not satisfied, contact support for a full refund.

T Troubleshooting

Messages aren't sending. What should I check?
1) Verify device is online in the dashboard. 2) Check SIM card has SMS credit/plan. 3) Verify phone number format (E.164 format recommended). 4) Check API key permissions. 5) Review error logs in the dashboard.
How do I handle delivery failures?
Failed messages include error codes in the webhook callback and dashboard. Common issues: invalid number, blocked by carrier, insufficient SMS credit. Enable delivery confirmations to track status.
App keeps disconnecting. How do I fix it?
Ensure battery optimization is disabled, app has all required permissions, and a stable internet connection (Wi-Fi recommended). Check for Android system updates and ensure the app is up to date.

Additional Resources

Everything you need to master SMS Gateway

Documentation

Comprehensive guides covering installation, configuration, and advanced features.

Browse Docs →

Video Tutorials

Step-by-step video guides for common tasks and configurations.

Watch Videos →

GitHub Issues

Report bugs, request features, and track development progress.

View Issues →

Still Need Help?

Our support team is here to help you succeed with SMS Gateway.