> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beem.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Prerequisites

> Create a Beem account, set up a Moja channel, and obtain API credentials.

Before integrating the Moja API, ensure your Beem account, messaging channel, and API credentials are configured.

## 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](/guides/moja/whatsapp-templates))
* For **inbound messages and delivery reports** — a publicly accessible **HTTPS callback URL** (see [Inbound callbacks](/guides/moja/inbound-callbacks) and [Delivery reports](/guides/moja/delivery-reports))

***

## Steps to get started

<Steps>
  <Step title="Create an account">
    Create a free account at [login.beem.africa](https://login.beem.africa/#!/register).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Sign in">
    Log in to the [Beem Dashboard](https://login.beem.africa/?client_id=BOT#!/).
  </Step>

  <Step title="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).
  </Step>

  <Step title="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.

    <Info>
      For automated bot integrations, contact [operations@beem.africa](mailto:operations@beem.africa).
    </Info>
  </Step>

  <Step title="Generate API credentials">
    Navigate to **MOJA → API Setup** in the Beem dashboard and click **Generate API Key and Secret**.

    <Warning>
      The Secret is only displayed once. Store it safely before leaving the page.
    </Warning>
  </Step>
</Steps>

***

## 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**

<Info>
  See [Authentication](/guides/moja/authentication) for request examples using Basic Auth or an access token.
</Info>