Get Started in 5 Minutes
Follow this step-by-step guide to send your first SMS via API.
Your Progress
0/5 steps completedStep 1: Download the App
First, download and install the Group SMS app on your Android phone. This app will act as your SMS gateway.
System Requirements
- ✓ Android 7.0 (API 24) or higher
- ✓ Active phone plan with SMS capability
- ✓ Internet connection (Wi-Fi or mobile data)
Step 2: Create an Account
Open the app and create your account using phone number verification.
Why phone verification?: We verify your phone number to ensure you own the device that will send SMS messages.
- 1.Open the Group SMS app
- 2.Tap "Get Started" and enter your phone number
- 3.Enter the verification code sent to your phone
Step 3: Generate API Key
Generate your API key from the app settings. This key will authenticate your API requests.
- 1.In the app, tap the menu icon (☰) in the top-left
- 2.Navigate to Settings > Developer API
- 3.Tap "Generate API Key"
- 4.Copy and securely store your API key
⚠️ Important: Keep your API key secret! Anyone with your key can send SMS using your phone. Never commit API keys to version control.
Example API Key
gsms_live_1a2b3c4d5e6f7g8h9i0jStep 4: Make Your First API Call
Try sending a test SMS using cURL. Replace YOUR_API_KEY_HERE with your actual API key and update the phone number.
Replace YOUR_API_KEY_HERE with your API key and +821012345678 with your test phone number:
curl -X POST https://api-2ue64mzmvq-du.a.run.app/api/v1/developer/send \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"recipients":[{"phone":"+821012345678","message":"Test message from Group SMS API!"}]}'Expected Response
{
"success": true,
"batchId": "batch_1736416234_a1b2c3",
"totalCount": 1,
"estimatedDeliveryTime": "2-5 minutes"
}Step 5: Verify Delivery
Check that your message was sent successfully.
- 1.Check your test phone - you should receive the SMS within 2-5 minutes
- 2.In the Group SMS app, go to "Messages" tab to see sent messages
- 3.Use the batch ID from the response to check status via the /status endpoint
✓ Success: You've successfully sent your first SMS via API! Now explore the full API documentation to integrate SMS into your application.
Need Help?
Can't get it working? Check our documentation or visit the FAQ.