Alphanumeric Sender IDs

When sending SMS internationally (to supported countries), you can brand your messages using an alphanumeric Sender ID instead of a standard phone number. Sender IDs must be approved by our team before they can be used for outbound messaging.

List Sender IDs

Retrieve all Sender IDs associated with the current project, including their approval status.

GET /v1/sms/sender-ids

Response

{
  "data": [
    {
      "id": 4,
      "sender_id": "SendAPI",
      "status": "approved",
      "created_at": "2026-03-09T14:30:00.000000Z"
    },
    {
      "id": 5,
      "sender_id": "MyBrand",
      "status": "pending",
      "created_at": "2026-03-10T09:15:00.000000Z"
    }
  ]
}

---

Submit a Sender ID

Submit a new alphanumeric Sender ID for review.

POST /v1/sms/sender-ids

Rules for Sender IDs:

• Must be between 3 and 11 characters.
• Must only contain letters (A-Z) and numbers (0-9).
• Must contain at least one letter.
• Cannot be purely numeric.
• Must accurately represent your brand or business name.

Request Body

Parameter	Type	Required	Description
sender_id	string	Yes	The exact alphanumeric string you wish to use (e.g., SendAPI).

curl -X POST https://sendapi.co/v1/sms/sender-ids \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "MyBrand"
  }'

---

Delete a Sender ID

Remove a Sender ID from your account.

DELETE /v1/sms/sender-ids/{id}

Support Wait Times

Sender ID approvals are processed manually to comply with telecom carrier anti-spam regulations. Approvals typically take between 24 and 48 business hours. If your application is rejected, our support team will reach out to the account owner's email with the reason.