Skip to main content
When someone receives an SMS from your business, the first thing they see is who sent it. A custom Sender ID replaces a generic phone number with your brand name, making your messages instantly recognizable and building trust with every delivery. Hany lets you register and manage multiple Sender IDs directly from your dashboard.

​
What Is a Sender ID?

A Sender ID is the alphanumeric name displayed in the “From” field on a recipient’s phone. Instead of seeing +233XXXXXXXXX, your customer sees a name like MyBrand, MyBank, or AppAlert. Sender IDs must be up to 11 alphanumeric characters and are registered per business. Once approved, you reference your Sender ID in every API call or dashboard message you send. Examples of valid Sender IDs:
Sender IDUse Case
MyBrandGeneral marketing messages
MyBankBanking alerts and OTPs
AppAlertApplication notifications
ShopNowE-commerce promotions

​
Registering a Sender ID

1

Log in to your Hany dashboard

Visit hany.tools and sign in to your account.
2

Navigate to SMS → Sender IDs

From the left-hand navigation menu, select SMS, then click Sender IDs.
3

Click Register Sender ID

Select the Register Sender ID button in the top-right corner of the page.
4

Enter your desired name and submit

Type in the Sender ID name you want to register and click Submit for Approval. You may be prompted to provide supporting business documents at this stage.
5

Wait for verification

Hany’s compliance team reviews all Sender ID submissions. Approval typically takes 1–3 business days. You’ll receive an email notification when your Sender ID is approved or if further information is needed.
Sender ID registration may require business verification documents, such as a certificate of incorporation or a business registration certificate. Have these ready to speed up the approval process.

​
Sender ID Rules

Follow these guidelines to ensure your Sender ID is approved without delays:
  • Maximum 11 characters — Sender IDs longer than 11 characters are not supported by carrier networks.
  • Alphanumeric only — You may use letters (A–Z, a–z) and numbers (0–9). No hyphens, underscores, or other symbols.
  • No spaces or special characters — Spaces, underscores, hyphens, punctuation, and all other symbols are not allowed.
  • Must represent your business — Your Sender ID must match or clearly relate to your registered business name or brand.
  • No impersonation — You cannot register Sender IDs that impersonate other brands, government agencies, financial institutions, or use reserved or protected names.
Submitting a Sender ID that impersonates another brand or violates carrier policies will result in rejection and may lead to account suspension.

​
Using Your Sender ID

Once your Sender ID is approved, pass it as the from field in your API requests. 
curl -X POST https://api.hany.tools/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+233XXXXXXXXX",
    "from": "YourBrand",
    "message": "Your OTP is 123456"
  }'
Replace YourBrand with your exact approved Sender ID. If you use a Sender ID that has not been registered or is still pending approval, the request will return an error.

​
Checking Your Sender ID Status

From the dashboard: Go to SMS → Sender IDs to see a list of all your registered Sender IDs along with their current status: Pending, Approved, or Rejected. Via the API: Retrieve your Sender IDs and their statuses programmatically: 
curl -X GET https://api.hany.tools/v1/sms/sender-ids \
  -H "Authorization: Bearer YOUR_API_KEY"
Example response: 
{
  "status": "success",
  "sender_ids": [
    {
      "name": "YourBrand",
      "status": "approved",
      "created_at": "2025-01-15T10:30:00Z"
    },
    {
      "name": "AlertsOnly",
      "status": "pending",
      "created_at": "2025-01-18T08:00:00Z"
    }
  ]
}
Registering via the API: You can also submit a new Sender ID programmatically using a POST request: 
curl -X POST https://api.hany.tools/v1/sms/sender-ids \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "YourBrand"
  }'
Example response: 
{
  "status": "success",
  "sender_id": {
    "name": "YourBrand",
    "status": "pending",
    "created_at": "2025-01-20T09:00:00Z"
  }
}
The Sender ID is created with a pending status and enters the standard 1–3 business day review queue. You will be notified by email when the status changes.
Register your Sender IDs as early as possible. Approval takes 1–3 business days, so submitting ahead of your planned send date ensures your brand name is ready to go when you need it.