Alphanumeric sender IDs

A sender ID lets your texts arrive from a name such as ACME instead of a number, the way banks and airlines send alerts. There is no number to buy, no monthly fee and no US registration. The trade-off: recipients cannot reply, and sender IDs do not work for the US, Canada or Puerto Rico.

#When to use one

#Create the name

POST /v1/sms/sender-ids with a senderId. It is usable at once.

curl -X POST https://api.pozy.ai/v1/sms/sender-ids \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "senderId": "ACME" }'

const res = await fetch("https://api.pozy.ai/v1/sms/sender-ids", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ senderId: "ACME" }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.id, data.isActive);

import os, requests

resp = requests.post(
    "https://api.pozy.ai/v1/sms/sender-ids",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={"senderId": "ACME"},
    timeout=30,
)
print(resp.json())

Rules for the name:

• 3 to 11 characters: letters, digits and spaces, with at least one letter.
• It must be your own brand. Names that imitate well-known brands or institutions (banks, payment providers, delivery companies, government bodies) are rejected with 422.
• Names are not exclusive. Other workspaces can register the same name. Billing and delivery receipts always follow the workspace that sent the message.

DELETE /v1/sms/sender-ids/{id} deactivates a name. Creating the same name again brings it back.

#Send from it

Pass the name as from on the normal send endpoint:

curl -X POST https://api.pozy.ai/v1/sms/messages \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "ACME", "to": "+34612345678", "text": "Your Acme verification code is 482913" }'

Each segment bills at the destination's normal SMS rate. Delivery is reported with message.delivered and message.failed, like any SMS. See Send SMS.

#How countries display it

#Daily limit

Texts sent from sender IDs count against a daily limit that resets at midnight UTC. When it is reached, sends from a sender ID answer 429 until the reset. Texts from your phone numbers are not affected.

GET /v1/sms/sender-ids returns your names. Write to support@pozy.ai to raise your sender ID limit, with what the texts are for, who receives them and roughly how many you send a day. POST /v1/sms/sender-ids/limit-request is not available yet and answers 403 with code: "feature_not_available".

#Limits

#Errors

#Endpoints