Sender ID API

Every SMS you send needs an approved sender ID — the name recipients see instead of a phone number. Register, list, update, and remove the sender IDs tied to your business through four simple endpoints.

Four Sender ID Types

ALPHANUMERIC, DEDICATED, and SHARED brand names, plus numeric SHORT_CODE — pick what fits how you send.

Reviewed Before Use

Every new sender ID starts PENDING and only becomes usable for sending once approved.

Duplicate Protection

Exact and case-insensitive matches against your existing sender IDs are rejected up front.

Usage Stats Included

Every sender ID in the list response carries totalMessages and totalCampaigns counts.

Types

ALPHANUMERIC, DEDICATED, SHARED, SHORT_CODE

Name Length

3–11

Chars (3–6 digits for SHORT_CODE)

Default Status

PENDING

Until an admin reviews it

Use Case

10–500

Chars, required on create

Authentication

All requests use HTTP Basic Auth with the Base64 token from your dashboard. See Authentication →

Quick Start — Register a Sender ID

Request the sender ID

Call /v1/sender-idswith the name, type, and a description of what you'll send.

Bash

curl -X POST 'https://api.sendexa.co/v1/sender-ids' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN' \
  -d '{
    "name": "YourBrand",
    "useCase": "Order confirmations and delivery updates for our store.",
    "type": "ALPHANUMERIC"
  }'

It sits at PENDING

New sender IDs are never auto-approved. Check status via the list endpoint, or watch for the approval email sent to your account.

Send once APPROVED

Once approved, use the exact name as the from field on SMS send requests.

API Endpoints

GET

/v1/sender-ids

List Sender IDs

Fetch your business's sender IDs, filterable by status, type, and name.

Request a new sender ID. Created as PENDING pending review.

Edit the use case on a sender ID that's still PENDING.

Remove a sender ID that has no messages or campaigns using it.

View docs

Sender ID Types

Type	Format	Example	Best For
ALPHANUMERIC	3–11 chars, letters/digits/spaces	YourBrand	Standard branded sending — the default choice for most businesses.
DEDICATED	3–11 chars, letters/digits/spaces	Catlog	A sender ID used exclusively by one business, not shared with others.
SHARED	3–11 chars, letters/digits/spaces	Letcol	A pooled sender ID one operator uses across several related businesses.
SHORT_CODE	3–6 digits only	2024	Numeric short codes for two-way or campaign-style messaging.

Status Values

Status	Meaning
PENDING	Default on creation. Not usable for sending yet — editable via the update endpoint.
APPROVED	Reviewed and cleared. Use this name as `from` on SMS send requests.
REJECTED	Did not pass review. Create a new request with a different name if needed.
UNDER_REVIEW	Being actively reviewed by an admin.