An alphanumeric sender ID puts your brand name in the from field instead of a number. Many countries require you to pre-register that name before it can deliver. Bird files the registration and reports its status through the API so you know when the sender is live.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const code = generateOtp();
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."Today at 2:14 PM
Why some senders need registering first.
Sender-ID registration is part of SMS compliance on the Bird SMS API. To curb spoofing, a number of countries only deliver alphanumeric sender IDs that have been pre-registered with the local carriers or regulator. Where that applies, an unregistered branded sender is rejected or rewritten. Bird files the registration for you and exposes its state, so you don't send into a sender that can't deliver yet.
How registration works.
Where it's required, who files it, and when it's live.
- 01
Know where it's required.
Whether an alphanumeric sender ID needs registering depends on the destination country. Some require pre-registration, some allow dynamic senders, and some don't permit alphanumeric at all.
- 02
Bird files it for you.
Submit the sender ID and the destination from the dashboard. Bird carries the registration to the local carriers or regulator on your behalf.
- 03
Track status through the API.
Approval runs through external registries and takes days to weeks. Poll the registration's state so your code waits for it before sending from that sender ID.
- 04
It applies to alphanumeric senders.
Registration governs the alphanumeric sender ID itself. Sending from numbers — long codes, short codes, toll-free — follows the rules of those number types instead.
Check a registration's status from the API.
You file the sender ID from the dashboard; the API tells you where it stands per destination. Read the registration and branch on its status before you send from that sender.
const { data: senderId } = await bird.sms.compliance.senderIds
.get("Bird")
.safe();
if (senderId.status === "registered") {
// safe to send from this sender ID in that country
}
console.log(senderId.country); // → "IN"Registration follows the alphanumeric sender.
This is the compliance step behind alphanumeric sender IDs. The sender type lets you send from a brand name where the country allows it; registration is what makes that name deliverable where the country requires it first.
Sender-ID registration FAQ
What is an alphanumeric sender ID?+
Why do I have to register one?+
Who files the registration?+
How long does it take?+
Other compliance topics
Sender-ID registration is one of three SMS compliance regimes. See the rest.
Register your sender ID, then send branded.
Sender-ID registration is one regime of SMS compliance on Bird. File from the dashboard, track approval through the API, and send from your brand name where it's allowed.