Issue
When sending an outbound text message or WhatsApp message, the request fails with Error 21212: Invalid 'From' Number. The system states that the sender information you supplied was not a valid phone number, Alphanumeric Sender ID, or approved WhatsApp Sender. This blocks your outbound communications from being successfully delivered to your customers.
Product
Programmable Messaging
Environment
Twilio Console
Cause
This issue happens when the platform does not recognize or authorize the identity placed in the "From" field of your request. Common reasons include:
- The phone number is missing the country code or correct formatting.
- You are using a business name (Alphanumeric Sender ID) on a free trial account, which is not supported.
- The business name you chose is too generic (like "SMS" or "INFO") and was automatically blocked.
- Your WhatsApp Sender profile is still pending and has not been fully approved yet.
Resolution
Follow these steps to resolve the error and successfully send your messages:
-
Check Phone Number Formatting: Ensure the sender phone number is in the standard E.164 format. This means it must include a plus sign followed by the country code and phone number (for example:
+15550199). - Upgrade Trial Accounts: If you are trying to send messages using a brand or business name instead of a phone number, make sure your account is upgraded. Trial accounts cannot use this feature.
- Change Generic Business Names: If you are using a custom business name, ensure it is unique. Avoid generic words. If a custom name is still failing, you may need to open a support ticket to get it manually approved.
- Verify WhatsApp Status: If you are sending a WhatsApp message, log into your account and confirm that your WhatsApp Sender profile status is marked as "Approved" and onboarding is complete.
- Use a Messaging Service SID: If you are routing messages through a sender pool or using advanced features like RCS, try using the Messaging Service SID instead of a single phone number in your request.
Additional Information
If you have verified your formatting and account status but the error persists, please open a support ticket and provide a recent Message SID or Call SID so our team can investigate further.