Skip to content

Describe accepted recipient formats #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vernu merged 2 commits into from
Nov 5, 2026
Merged

Describe accepted recipient formats #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1c153f9
docs: describe accepted recipient formats
vernu Nov 5, 2026
4d2ba11
docs: note that some short codes work on one carrier only
vernu Nov 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -215,6 +215,8 @@ It is best effort: characters with no safe equivalent pass through untouched. Ch

### Phone number helpers

textbee does not require international format. Local numbers are sent as written and reach recipients in the same country as the sending SIM. Short codes are sent as written too. They work only in the sending SIM's country, and some work only on one carrier. International format works for every recipient, so use these helpers when you send to more than one country or match replies to stored numbers.

```python
from textbee import is_valid_e164, normalize_phone_number

Expand Down
6 changes: 5 additions & 1 deletion src/textbee/_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,11 @@ def send_sms(
) -> SendSmsResponse:
"""Send an SMS to one or more recipients.

``recipients`` are phone numbers in international format.
``recipients`` are phone numbers or short codes. International format
(``+12025550123``) reaches any country. Local numbers reach recipients
in the sending SIM's country. Short codes work only in that country,
and some only on one carrier. Values with letters are rejected with
400.

``device_id`` picks the sending phone. Get ids from ``get_devices()``.
Omit it and textbee picks the sender: your default device first,
Expand Down
Loading