Authentication

Create a Beem account

Create a free account at:https://login.beem.africaAfter registration, verify your email address and phone number. You’ll receive a confirmation email — click the verification link to activate your account.

Create an application

Navigate to Applications under the OTP menu and create a new application.Choose the channel you want to use for OTP delivery.Available channels include:

Tanzania SMS API (enabled by default)
Multi-country SMS
WhatsApp (WhatsApp setup required)

If you want to use international SMS:

Open Profile
Select International API
Add your international SMS username and password

Generate API credentials

Navigate to:OTP → API SetupClick Generate API Key & Secret.

Your API Secret is displayed only once. Store it securely, as it cannot be viewed again.

If needed, you can return to API Setup later to disable your current credentials and generate a new API Key and Secret.

Authentication methods

All OTP 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.

API Key & Secret
Access Token

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

Username: API Key
Password: API Secret

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

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

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

POST /request HTTP/1.1
Host: otp.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

​Authentication methods

Authentication methods