Twilio Error 30034: Message From an Unregistered Number
Updated
Short answer: Twilio returns error 30034 when you text a US number from a +1 10DLC number that is not associated with an approved A2P 10DLC campaign. Finish brand and campaign registration, then add the number to the Sender Pool of the Messaging Service linked to the approved campaign. A Sole Proprietor campaign can register only one 10DLC number, so any extra numbers stay unregistered.
What error 30034 means
Twilio's title for this code is "30034: US A2P 10DLC - Message from an Unregistered Number". The error page says:
"Twilio blocks messages to U.S. numbers when you send from a +1 10DLC number that is not associated with an approved A2P 10DLC Campaign. To send application-to-person traffic over a U.S. long code, complete A2P 10DLC registration and make sure the number is attached to the Messaging Service associated with your approved Campaign."
Registration applies to everyone who texts this way: "Anyone sending SMS/MMS messages over a 10DLC number from an application to the US must register for A2P 10DLC." It has two parts. The Brand tells carriers who is sending. The Campaign describes how people opt in, opt out and get help, and what the messages are for.
Common causes
Twilio lists four:
- "You sent a message to a U.S. number from a +1 10DLC number that is not associated with an approved A2P 10DLC Campaign."
- "Your Brand or Campaign registration is not complete, so the number is still unregistered for U.S.-bound 10DLC traffic."
- "The phone number is not in the Sender Pool of the Messaging Service linked to your approved Campaign."
- "You added multiple +1 10DLC numbers to a Sole Proprietor Campaign. Only one 10DLC number can be registered for that Campaign. Additional numbers remain unregistered."
How to fix error 30034
- Finish registration. "Complete A2P 10DLC registration for your Brand and Campaign before sending messages to U.S. numbers from a +1 10DLC number."
- Put the number in the right Sender Pool. "Add the phone number to the Sender Pool of the Messaging Service associated with your approved Campaign."
- Check the number's status. "Verify the number's A2P registration status. If the number is still unregistered, update the Messaging Service and Campaign association so the number is linked to a verified Campaign."
- Keep one number on a Sole Proprietor campaign. "If you use a Sole Proprietor Campaign, keep only the single +1 10DLC number you want to use in that Messaging Service." If you register an existing Messaging Service with several 10DLC numbers to a Sole Proprietor campaign, Twilio says "a random 10DLC number will be chosen from your 10DLC numbers as the verified 10DLC route. You can't choose which number gets registered."
- Need to send before approval? Twilio suggests "a sender type that is not part of A2P 10DLC, such as a Toll-Free number, short code, or Twilio Verify for verification use cases." A toll-free number needs its own verification first. See toll-free verification vs A2P 10DLC.
Related codes
| Code | Twilio title | What it means |
|---|---|---|
| 30035 | "US A2P 10DLC - Message from a number still being configured" | The number is still being configured for US A2P 10DLC |
| 30125 | "Your phone number could not be registered with US A2P 10DLC" | A warning when you add a number to a Messaging Service whose Sole Proprietor campaign already has a registered sender |
| 30126 | "Your 10DLC number failed to be registered" | Twilio could not complete the backend registration or deregistration of the number |
| 30033 | "US A2P 10DLC - Campaign Suspended" | The sending campaign is suspended |
If you use HighLevel
HighLevel gives two causes for 30034: the sending number "is not linked to a valid, approved A2P campaign", or "a Sole Proprietor registration has more than one local number". Campaign approval does not link every number for you. HighLevel says: "Check each applicable number on the Phone Numbers page. A linked number displays the green A2P Verified label."
HighLevel limits Sole Proprietor accounts to one number per campaign and warns: "Accounts purchasing multiple local numbers may encounter errors when texting, specifically error code 30034, even with approved numbers." Toll-free numbers are separate. They "do not use A2P campaign linking and follow a separate verification process."
How to avoid it next time
- Do not send from a new number until its registration status shows it is linked to an approved campaign.
- Plan around the Sole Proprietor limit. Twilio says "each Sole Proprietor Campaign can only use one Phone Number to send messages, but a Standard/LVS Campaign can have many".
- Improve the chances that your campaign passes review. Precheckly's free A2P 10DLC sample checker checks that you have at least two samples, that each names the brand and that at least one has an opt-out instruction.
Registering also lowers message filtering, which shows up as Twilio error 30007. For rejection codes you may meet along the way, see the list of A2P 10DLC error codes.
Sources
- 30034: US A2P 10DLC - Message from an Unregistered Number, Twilio
- 30035: US A2P 10DLC - Message from a number still being configured, Twilio
- 30125: Your phone number could not be registered with US A2P 10DLC, Twilio
- 30126: Your 10DLC number failed to be registered, Twilio
- 30033: US A2P 10DLC - Campaign Suspended, Twilio
- Programmable Messaging and A2P 10DLC, Twilio
- Direct Sole Proprietor Registration Overview, Twilio
- Troubleshooting and rectifying Campaigns, Twilio
- Error 30034: Linking a Phone Number to an Approved A2P Campaign, HighLevel
- Registering Your A2P Brand, HighLevel
Not legal advice. Carrier rules and provider documentation change, so check the linked sources before you rely on them.