Quickstart

Get your first message sent in under 5 minutes. Follow these four steps.

Step 1: Create an Account

Visit app.galatext.com and sign up for a free account. You'll get 50 free credits to start testing immediately — no credit card required.

Step 2: Get Your API Key

1. Log in to the dashboard
2. Navigate to Settings → API Keys
3. Click Create New Key
4. Copy the key and store it securely

⚠️ Security Note: Never share your API key or commit it to version control. Use environment variables to store it.

Step 3: Top Up Credits

By default, your account includes free trial credits. To send production messages:

1. Go to Billing → Top Up in the dashboard
2. Choose a credit package
3. Complete payment via mobile money or card

Each SMS costs 1 credit per message segment (160 characters).

Step 4: Send Your First SMS

You're ready to send your first message. Replace YOUR_API_KEY with the key from Step 2:

curl -X POST https://api.galatext.com/api/sms/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "phoneNumber": "+2547XXXXXXXX",
    "message": "Hello from Galatext!",
    "senderId": "GALATEX"
  }'

Expected Response

{
  "success": true,
  "data": {
    "messageId": "msg_abc123def456",
    "status": "PENDING",
    "phoneNumber": "+2547XXXXXXXX",
    "creditsUsed": 1,
    "creditsRemaining": 49
  }
}

If successful, you'll receive a 202 Accepted response with a messageId. The message will be delivered within seconds.

Next Steps

• 📖 Read the full API reference
• 📱 Learn about sending WhatsApp messages
• 🔗 Set up webhooks for delivery reports
• 📦 Explore SDKs and libraries
• ❓ Check error codes if something goes wrong

Troubleshooting

Problem	Solution
401 Unauthorized	Check your API key is correct and active
402 Payment Required	Your credits are exhausted — top up
422 Unprocessable	Validate phone number format (E.164)
429 Too Many Requests	You've hit the rate limit — slow down

Send your messages in 8+ countries across Africa with carriers optimized for high delivery rates.