UConnect SMS/Email Gateway API
Complete documentation for integrating SMS and Email services into your applications.
🚀 Quick Start
The UConnect Gateway API allows you to send SMS and Email messages programmatically. This guide will help you get started in minutes.
Base URL
https://uconect.ulibtech.org
Prerequisites
- ✅ Active UConnect Gateway account
- ✅ API Key (obtained after registration)
- ✅ Sufficient credits in your account
📋 API Overview
🔐 Authentication
Secure your requests with API keys
- Register & Login
- API Key Management
- Profile Updates
👤 User Management
Manage your account
- Check Balance
- View Transactions
- User Statistics
💻 Quick Example
Here's a simple example to send your first SMS:
curl -X POST https://uconect.ulibtech.org/api/sms/send \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"number": "+256700000000",
"message": "Hello from UConnect!",
"senderid": "MYAPP"
}'
const response = await fetch('https://uconect.ulibtech.org/api/sms/send', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here'
},
body: JSON.stringify({
number: '+256700000000',
message: 'Hello from UConnect!',
senderid: 'MYAPP'
})
});
const result = await response.json();
console.log(result);
import requests
url = 'https://uconect.ulibtech.org/api/sms/send'
headers = {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here'
}
data = {
'number': '+256700000000',
'message': 'Hello from UConnect!',
'senderid': 'MYAPP'
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
'+256700000000',
'message' => 'Hello from UConnect!',
'senderid' => 'MYAPP'
);
$options = array(
'http' => array(
'header' => "Content-Type: application/json\r\n" .
"X-API-Key: your_api_key_here\r\n",
'method' => 'POST',
'content' => json_encode($data)
)
);
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
print_r(json_decode($result));
?>
⚠️ Error Codes
| Code | Status | Description |
|---|---|---|
200 |
Success | Request completed successfully |
201 |
Created | Resource created successfully |
400 |
Bad Request | Invalid request parameters |
401 |
Unauthorized | Invalid or missing API key |
402 |
Payment Required | Insufficient credits |
403 |
Forbidden | Access denied (admin required) |
404 |
Not Found | Resource not found |
500 |
Server Error | Internal server error |
⚡ Rate Limits & Restrictions
SMS Limits
- Bulk SMS: 100 recipients per batch
- Message Length: 1600 characters max
- Sender ID: 11 characters max
- Priority: 0-4 (0=highest)
Email Limits
- Bulk Email: 50 recipients per batch
- Subject: 200 characters max
- Content: No hard limit
- Attachments: Supported
API Requests
- Rate Limit: Based on credits
- Concurrent: No hard limit
- Authentication: Required on all endpoints
- CORS: Enabled
Costs
- SMS: Configurable per unit
- Email: Configurable per email
- Signup Bonus: 5.00 credits
- Payment: Contact admin
👤 User Endpoints
GET
/api/user/balance
Get current credit balance
GET
/api/user/transactions
List all credit transactions
GET
/api/user/stats
Get user statistics (SMS/Email sent, total spent)
POST
/api/user/regenerate-key
Generate new API key (invalidates old key)
PUT
/api/user/profile
Update user profile (email, phone, password)
📞 Support
Need help? We're here for you!
- 📧 Email: support@ulibtech.org
- 💬 Status: Available 24/7
- 📚 Resources: Check our detailed endpoint documentation