Quickstart

Create an account

Create a project

Navigate to Projects and create a new project. Each project has its own API token and sender ID.

Copy your API token

Open the project details page and copy the API token. Store it in an environment variable — never hardcode it.

export ERSAAL_API_TOKEN="your_token_here"

Send your first message

curl -X POST https://sms.lamah.com/api/sms/messages \
  -H "Authorization: Bearer $ERSAAL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello from Ersaal!",
    "sender": "MySender",
    "payment_type": "wallet",
    "receiver": "00218912345678"
  }'

Response:

{
  "message_id": "msg_123456789",
  "cost": 1
}

Use the message_id to track delivery status via the Get Message endpoint.

Code examples

const response = await fetch('https://sms.lamah.com/api/sms/messages', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ERSAAL_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'Hello from Ersaal!',
    sender: 'MySender',
    payment_type: 'wallet',
    receiver: '00218912345678',
  }),
});

const data = await response.json();
console.log(data.message_id);

import requests
import os

response = requests.post(
    'https://sms.lamah.com/api/sms/messages',
    headers={
        'Authorization': f'Bearer {os.getenv("ERSAAL_API_TOKEN")}',
        'Content-Type': 'application/json',
    },
    json={
        'message': 'Hello from Ersaal!',
        'sender': 'MySender',
        'payment_type': 'wallet',
        'receiver': '00218912345678',
    }
)

print(response.json())

$response = Http::withToken(env('ERSAAL_API_TOKEN'))
    ->post('https://sms.lamah.com/api/sms/messages', [
        'message'      => 'Hello from Ersaal!',
        'sender'       => 'MySender',
        'payment_type' => 'wallet',
        'receiver'     => '00218912345678',
    ]);

echo $response->json('message_id');