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

# Send SMS via Dojah Messaging API

> Deliver OTPs, alerts, and transactional SMS. One API, instant delivery, and full status tracking.

Send high-priority transactional SMS messages to your users
using Dojah’s Messaging API. Whether it's delivering
payment confirmations, or onboarding alerts, messages are routed instantly with full
visibility into delivery status.

***

#### How It Works

Before you can start sending messages, you must register a Sender ID. This is the alphanumeric name that appears as the sender (e.g., DOJAH, MYBANK). You can request a Sender ID via the [Request Sender ID API](/docs/messaging/sender-id). Once approved, it becomes available for use in your API calls.

**To send a message**:

* Register and activate your Sender ID

* Make a POST request to the messaging endpoint with the recipient’s phone number and message body

* Receive a message\_id in response for tracking status

Optionally, poll the status endpoint using the message\_id to track delivery lifecycle

**Statuses include**:

* queued – Message is awaiting dispatch

* sent – Message has been handed to the telco

* delivered – Successfully received by the user

* failed – Delivery failed (e.g., invalid number or telco issue)

#### Use Cases

* Payment or wallet transaction alerts

* Loan disbursement or status updates

* Onboarding verification messages

#### Message Status Tracking

Use the GET /status endpoint with the message\_id to track the real-time state of any message. This provides a full audit trail across your communication touchpoints and ensures reliability in delivery.