Sender IDs

A sender ID is the name shown on the recipient’s handset instead of a phone number. Every message must go out under one that is registered to your account and approved.

Rules

Maximum 11 characters.
Must represent a name, brand, or organisation you are entitled to use. Sender IDs that appear to impersonate another party are rejected.
Approval is not instant — it is reviewed, and the mobile networks and TCRA can refuse or withdraw one at any time.

A sender ID is registered with a purpose, and it matters for delivery:

TRANSACTIONAL — receipts, confirmations, one-time passcodes.
PROMOTIONAL — marketing.

Networks treat the two differently, and promotional traffic is filtered more aggressively. Sending one-time passcodes under a promotional sender ID is a common cause of poor delivery.

Endpoints

Method	Path	Purpose
`POST`	`/sender-ids`	Register a new sender ID
`GET`	`/sender-ids`	List yours, with status
`GET`	`/sender-ids/{senderId}`	Fetch one
`PUT`	`/sender-ids/{senderId}`	Update description or purpose
`DELETE`	`/sender-ids/{senderId}`	Remove one

Register a sender ID

string

required

The name recipients see. Maximum 11 characters.

string

required

TRANSACTIONAL or PROMOTIONAL.

string

What the sender ID will be used for. Reviewers rely on this, so be specific.

curl -X POST https://api.huduma.cloud/sender-ids \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MYSHOP",
    "purpose": "TRANSACTIONAL",
    "description": "Order confirmations for myshop.co.tz customers"
  }'

Statuses

Status	Meaning
`pending`	Submitted, awaiting review. Cannot be used yet.
`active`	Approved. Ready to send.
`rejected`	Refused. `rejectionReason` explains why.

Getting started

API reference

Guides

Rules

Endpoints

Register a sender ID

Statuses

​Rules

​Endpoints

​Register a sender ID

​Statuses

Rules

Endpoints

Register a sender ID

Statuses