Authentication

Create a Beem account

Create a free account at:https://login.beem.africaAfter registering, verify your email address and phone number. You’ll receive a confirmation email — click the verification link to activate your account.If you have trouble completing email or phone verification, contact support@beem.africa.

Prepare your Sender ID

Before sending SMS messages, ensure you have an active Sender ID.

The default Sender ID INFO has been disabled for all accounts. Replace it with your approved Sender ID in every API request.

Generate API credentials

Navigate to:SMS → API SetupClick Generate API Key & Secret.The generated credentials are required to authenticate every request to the SMS API.

Your API Secret is shown only once. Store it securely, as it cannot be retrieved later.

Authentication methods

All SMS API requests require authentication. Use HTTP Basic Authentication (API Key and Secret) or pass an access token in the Authorization header. Use one method per request — not both.

Request headers

Header	Type	Description
`Content-Type`	string	`application/json` — used for JSON requests. `application/xml` — used for XML requests.

API Key & Secret
Access Token

Header	Value
`Authorization`	`Basic base64(api_key:secret_key)`
`Content-Type`	`application/json` or `application/xml`

Username: API Key
Password: API Secret

POST /v1/send HTTP/1.1
Host: apisms.beem.africa
Authorization: Basic <base64-encoded-api_key:secret_key>
Content-Type: application/json

Header	Value
`Authorization`	`<access-token>`
`Content-Type`	`application/json` or `application/xml`

Pass your access token directly — do not use a Bearer prefix.

POST /v1/send HTTP/1.1
Host: apisms.beem.africa
Authorization: <access-token>
Content-Type: application/json

Never expose your API Key, API Secret, or access token in frontend applications or public repositories.

Getting Started

APIs

Authentication methods

Request headers

​Authentication methods

​Request headers

Authentication methods

Request headers