Requirements
You will need:- A Beem account with email and phone number verified
- An active Moja channel (WhatsApp, SMS, or other supported channel) created and activated on your account
- API Key and Secret or an access token for authenticating API requests
- For WhatsApp Broadcast — at least one approved WhatsApp template (see WhatsApp templates)
- For inbound messages and delivery reports — a publicly accessible HTTPS callback URL (see Inbound callbacks and Delivery reports)
Steps to get started
1
Create an account
Create a free account at login.beem.africa.
2
Verify your email and phone
After registration, verify your email address and phone number. You’ll receive a confirmation email — click the link or paste it into your browser to activate your account.
3
Sign in
Log in to the Beem Dashboard.
4
Create a channel
From the Channels menu, select Create Channel and fill in the channel details for the messaging channel you want to use (for example, WhatsApp).
5
Wait for channel activation
The Beem team activates new channels after review. This process may take some time — you cannot send messages through the API until your channel is active.
For automated bot integrations, contact operations@beem.africa.
6
Generate API credentials
Navigate to MOJA → API Setup in the Beem dashboard and click Generate API Key and Secret.
Before you begin
Before making your first API request, verify that:- Your Beem account is active and you can sign in to the dashboard
- Your channel has been created and activated by the Beem team
- Your API Key and Secret (or access token) are available
- For template messaging, you have at least one approved WhatsApp template
- For inbound or delivery-report callbacks, your HTTPS endpoint is configured and returns HTTP 200 OK
See Authentication for request examples using Basic Auth or an access token.