Inbound two-way SMS - Beem API

When an inbound (mobile-originated) message is received, the Messaging Platform (MP) forwards it to your server via HTTP POST.

Callback URL configuration

For Multicountry SMS accounts, inbound two-way callback URLs are configured manually by the Beem team on your account. Contact support@beem.africa to register your HTTPS endpoint.

This is separate from Two-Way SMS (local REST product), which uses a callback URL configured per number in the dashboard.

Inbound parameters

Parameter	Description
`ID`	Original message ID (used when a reply to a previously sent message is received)
`SOURCEADDR`	Sender MSISDN or alphanumeric address
`SOURCEADDRTON`	Type of Number for source address
`SOURCEADDRNPI`	Numbering Plan Indicator for source address
`DESTADDR`	Your short code or long number
`MESSAGE`	Message content
`KEYWORD`	First word of an inbound message (when applicable)
`VP`	Validity period in seconds

Your server must respond with HTTP 200 OK. The response body should be empty and will be ignored.

Sample handler (PHP)

<?php
header('Content-Type: application/json');

if (!isset($_POST)) {
    echo json_encode(['error' => ['message' => 'nothing']]);
    die();
}

$from = urlencode($_POST['SOURCEADDR']);
$message = $_POST['MESSAGE'];
$destaddr = urlencode($_POST['DESTADDR']);

// Process the inbound message here

http_response_code(200);
?>

Sample implementations: beem-sms-txn-api-sample — callback

Delivery reports — receive DLRs via DLRADDRESS
Parameters reference — full send and receive parameter lists