Skip to main content
Sending an SMS through the Beem API follows a straightforward process.

How it works

1

1. Create your message

Your application prepares the SMS request, including:
  • Recipient phone number
  • Active Sender ID
  • Message content
2

2. Send the request

Your application submits the request to the Beem SMS API using Basic Auth (API Key and Secret) or an access token. Set Content-Type to application/json for JSON payloads or application/xml for XML payloads.The API authenticates your request before processing it.
3

3. Message processing

If the request is valid, Beem accepts the message and forwards it to the appropriate mobile network operator.
4

4. SMS delivery

The mobile network delivers the SMS to the recipient’s device.
5

5. Delivery report

Once delivery is attempted, Beem receives the delivery status from the mobile network.
For local SMS, delivery reports are not pushed to a callback URL. Use the pull mechanism only — call Get delivery reports with the request_id from your Send SMS response. Wait at least 5 minutes after sending before checking.