Phone Numbers

Every message must be sent from a phone number that is assigned to your account and in an Active state.

Viewing your numbers

Your assigned phone numbers are managed through the Textingline dashboard. Each number has a state indicating whether it can be used for sending.

Number states

Sender validation

When you include a from number in a send request, the API verifies:

1. Ownership — The number must be assigned to your account. If not, error 33004 is returned.
2. Active state — The number must be in Active state. If suspended or pending, error 33009 is returned.
3. Whitelabel configuration — The number must have an associated whitelabel configuration. If missing, error 33020 is returned.

Phone number formats

E.164 format

Recipient (to) and sender (from) phone numbers can use E.164 format — a + followed by the country code and subscriber number with no spaces or dashes:

+18005551234
+447911123456

Short codes

The from field also accepts short codes — 5 or 6 digit numbers used for high-throughput messaging:

12345
123456

Requests with invalid phone number formats are rejected with error code 33003.

Common errors

See Error Codes for the full reference.