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
View Auth Docs

📱 SMS API

Send SMS messages worldwide

  • Single SMS
  • Bulk SMS
  • Scheduled SMS
View SMS Docs

📧 Email API

Deliver emails reliably

  • Single Email
  • Bulk Email
  • HTML & Plain Text
View Email Docs

👤 User Management

Manage your account

  • Check Balance
  • View Transactions
  • User Statistics
View Endpoints

💻 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