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
| State | Can send? | Description |
|---|---|---|
| Active | Yes | The number is fully provisioned and ready to send |
| Suspended | No | The number has been temporarily suspended |
| Pending | No | The number is being provisioned and is not yet ready |
Sender validation
When you include a from number in a send request, the API verifies:
- Ownership — The number must be assigned to your account. If not, error
33004is returned. - Active state — The number must be in
Activestate. If suspended or pending, error33009is returned. - Whitelabel configuration — The number must have an associated whitelabel configuration. If missing, error
33020is returned.
E.164 format
All phone numbers in the API use E.164 format — a + followed by the country code and subscriber number with no spaces or dashes:
+18005551234
+447911123456Requests with invalid phone number formats are rejected with error code 33003.
Common errors
| Code | Description |
|---|---|
33003 | Phone number is not in valid E.164 format |
33004 | The from number is not assigned to your account |
33009 | The from number is not in an active state |
33020 | Account is not fully configured for messaging |
See Error Codes for the full reference.
Updated 3 days ago