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

# Register and Manage SMS Sender IDs for Your Business

> A Sender ID is the name recipients see when they receive your SMS. Learn how to register, verify, and use custom Sender IDs with Hany.

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 ID  | Use Case                   |
| ---------- | -------------------------- |
| `MyBrand`  | General marketing messages |
| `MyBank`   | Banking alerts and OTPs    |
| `AppAlert` | Application notifications  |
| `ShopNow`  | E-commerce promotions      |

## Registering a Sender ID

<Steps>
  <Step title="Log in to your Hany dashboard">
    Visit [hany.tools](https://hany.tools) and sign in to your account.
  </Step>

  <Step title="Navigate to SMS → Sender IDs">
    From the left-hand navigation menu, select **SMS**, then click **Sender IDs**.
  </Step>

  <Step title="Click Register Sender ID">
    Select the **Register Sender ID** button in the top-right corner of the page.
  </Step>

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

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

<Note>
  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.
</Note>

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

<Warning>
  Submitting a Sender ID that impersonates another brand or violates carrier policies will result in rejection and may lead to account suspension.
</Warning>

## Using Your Sender ID

Once your Sender ID is approved, pass it as the `from` field in your API requests.

```bash theme={null}
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:

```bash theme={null}
curl -X GET https://api.hany.tools/v1/sms/sender-ids \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Example response:**

```json theme={null}
{
  "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:

```bash theme={null}
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:**

```json theme={null}
{
  "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.

<Tip>
  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.
</Tip>