eSMS AfricaeSMS Africa
SMPP Portal

Credentials

SMPP user accounts for connecting to the gateway.

SMPP credentials allow clients to connect to the eSMS SMPP gateway and send messages.

SMPP connection settings

SettingValue
Hostsmpp.esmsafrica.io
Port2775 (plain TCP)
Bind typeTransceiver (transmitter and receiver also supported)
UsernameProvided by admin
PasswordProvided by admin
Source IPMust be on your bind's IP allowlist
ThroughputSet per bind, typically 100 messages per second; higher on request

Security and transport

SMPP runs over plain TCP on port 2775. The port is closed to the internet by default: it only accepts connections from the IP addresses on your bind's allowlist. TLS is not currently offered on the SMPP port. If your policy requires an encrypted link, contact support@esmsafrica.io to discuss options, or send over the HTTP API, which uses HTTPS (TLS 1.2 or 1.3).

Throughput

Throughput is set per bind. A typical limit is 100 messages per second. Higher limits are available on request, subject to the capacity of the destination routes. If you submit faster than your limit, the gateway rejects the extra submit_sm with ESME_RTHROTTLED (0x58). Pace your client to your limit and retry throttled messages after a short back-off.

Requesting credentials

  1. Log in to smpp.esmsafrica.io
  2. Go to SMPP Credentials
  3. Click Request Credential
  4. An administrator will review and approve your request

Once approved, your SMPP username and password are displayed in the credentials section.

Credential settings

Each SMPP credential includes:

SettingDescription
UsernameSMPP bind username
PasswordSMPP bind password
QuotaMaximum messages allowed
ThroughputMaximum messages per second
Allowed sendersPermitted sender IDs

Connecting

Use any SMPP client library to connect:

Python (smpplib)

import smpplib

client = smpplib.client.Client('smpp.esmsafrica.io', 2775)
client.connect()
client.bind_transceiver(
    system_id='your_username',
    password='your_password'
)

client.send_message(
    source_addr='eSMS',
    destination_addr='+254712345678',
    short_message='Hello via SMPP!'
)

Java (jSMPP)

SMPPSession session = new SMPPSession();
session.connectAndBind(
    "smpp.esmsafrica.io", 2775,
    new BindParameter(
        BindType.BIND_TRX,
        "your_username", "your_password",
        "SMPP", TypeOfNumber.UNKNOWN,
        NumberingPlanIndicator.UNKNOWN, null
    )
);

Test SMS

Send a test SMS from the dashboard to verify your credential is working:

  1. Go to your credential details
  2. Enter a test phone number
  3. Click Send Test

On this page