AlieSMS - Developer API Documentation

Authentication

The AlieSMS API uses Bearer Tokens to authenticate requests. You must include this token in the header of every API request you make.

How to get your API Token & User ID

Your secure API token and unique User ID are generated automatically when you create an account. You can find both by logging into your client dashboard and navigating to the Developers tab.

Example Header Requirement:

Authorization: Bearer YOUR_SECURE_API_TOKEN_HERE
Content-Type: application/json

Create Batch Message

This endpoint allows you to send a single SMS or a batch of messages to multiple recipients simultaneously.

Endpoint:

POST https://aliesmsapi.araknerd.com/message/batch/create

Request Body (JSON)

Important: You must replace "X" in the payload below with the actual numeric user_id provided in your dashboard.

Note: For strict system compatibility, the key "receipients" must be used exactly as spelled below.

{
  "user_id": "X",
  "batch_name": "System Alert Campaign",
  "message_text": "This is a test message from the AlieSMS API.",
  "receipients": "0701234567, 0771234567" 
}

Note:"x" and "y" are numbers.

Expected Response (Success)

{
  "status": "OK",
  "message": "Sent successfully! to x contacts, y contacts were duplicated",
  "details": "true"
}

Phone Formatting Rules

The "receipients" field accepts a single phone number or a comma-separated list of multiple numbers. To ensure high deliverability, your numbers must adhere to the local telecom specifications below:

General Format

All numbers must be exactly 10 characters long and begin with the prefix "07". Do not include the "+256" country code.

Airtel Networks

Airtel numbers must strictly begin with one of the following prefixes: 070, 074, 075, or 0795.

MTN Networks

MTN numbers must strictly begin with one of the following prefixes: 076, 077, 078, or 079.