Skip to main content
Before receiving inbound SMS messages, you need an active Beem account with a Two-Way SMS number assigned and a callback URL configured.
Multicountry SMS accounts: Inbound two-way callback URLs are not configured in the dashboard. Contact support@beem.africa to register your HTTPS endpoint. See Inbound two-way SMS (Multicountry).

​
Request a number and configure callback

1

Sign in

Log in to your account at login.beem.africa. Sign up and verify your email address and phone number if you are not already registered.
2

Request a number

Navigate to the SMS menu and open Two Way SMS. Select Request a Number based on your country and requirements.The Beem team will configure a valid short code or long code for your account. The assigned number will appear under Manage Numbers.
3

Set your callback URL

Edit the assigned number and update the callback URL for your application. This is the HTTPS endpoint where Beem will POST inbound messages.
4

Generate API credentials (optional)

To add an extra authentication step, you can validate the API Key on each callback request.
  1. Visit the SMS menu and click API Setup
  2. Click Generate API Key and Secret
The Secret is only displayed once. Store it safely before leaving the page.

​
Callback requirements

Your callback endpoint should:
  • Be publicly accessible over HTTPS
  • Accept HTTP POST requests with a JSON body
  • Respond quickly with a JSON acknowledgement
  • Return HTTP 200 OK for successful processing

​
Number types

Two-Way SMS numbers can be short codes or long codes depending on your country and use case. Keyword-based routing may also be available on certain number types. See beem.africa/two-way-sms-api for details on available number types and pricing.