> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beem.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound two-way SMS

> Receive mobile-originated messages from the Messaging Platform on your callback URL.

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](mailto:support@beem.africa) to register your HTTPS endpoint.

<Info>
  This is separate from [Two-Way SMS](/guides/two-way-sms) (local REST product), which uses a callback URL configured per number in the dashboard.
</Info>

***

## 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 theme={null}
<?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](https://github.com/beemafrica/beem-sms-txn-api-sample/tree/master/callback)

***

## Related

* [Delivery reports](/guides/multicountry-sms/delivery-reports) — receive DLRs via `DLRADDRESS`
* [Parameters reference](/guides/multicountry-sms/parameters) — full send and receive parameter lists