Want to activate a T-Mobile prepaid eSIM on your phone? It’s genuinely quick once you know the screens. Here’s the full setup on iPhone and Android, plus how to fix the common errors. New to eSIM? Start with what an eSIM card is.
About the T-Mobile Prepaid eSIM app
The T-Mobile Prepaid eSIM app activates a new T-Mobile prepaid line on iPhones and Android phones that support eSIM. It’s handy for travelers heading to the U.S., anyone who wants a second line, or folks who want to try the network before committing. It’s prepaid only (postpaid uses T-Mobile’s own eSIM flow). Make sure you’re on a solid Wi-Fi or cellular connection and that your phone is unlocked if you didn’t buy it from T-Mobile. Not sure your phone qualifies? Check the eSIM compatible device list.
How to activate T-Mobile prepaid service
Download the app
Get the T-Mobile Prepaid eSIM app from the App Store or Google Play.
Enter your email
Open the app, enter an email that isn’t already tied to a T-Mobile ID, and tap “Let’s go”.
Allow location and enter your ZIP
Allow location when prompted, then enter the ZIP code where you’ll mainly use the service and tap Continue.
Pick your plan
Choose a prepaid plan (tap “Plan details” to compare), then Continue and Accept the terms.
Pay and set a PIN
Enter your card details, CVC, and billing ZIP, set a 6 to 15 digit PIN, tap Review, then “Submit & pay”.
Install the eSIM
Wait while T-Mobile sets up service. On the “Install Cellular Plan” screen, tap Continue to download the eSIM, then name it and set your primary line.
Bringing a number from another provider? Contact T-Mobile support to port it in. Moving between phones is its own thing, see how to activate an eSIM for the general flow, and our quick guide to setting up a SIM or eSIM with T-Mobile for the short version.
Re-downloading your T-Mobile eSIM
You may need to re-download the eSIM if you deleted it by accident, you’re moving to a new phone, or the first download got interrupted. Switching iPhones? You can move the number during Quick Start or in device settings. Otherwise call T-Mobile at 1-877-778-2106 with your prepaid eSIM number or Order ID and your account PIN handy.
Troubleshooting common errors
| Error | What to do |
|---|---|
| Lost connection | Get a stronger Wi-Fi or cellular signal and retry. Switching Wi-Fi networks often helps. |
| Receipt isn’t ready | Give it a minute. You can also check account history on My T-Mobile. |
| Error 501 (incompatible/locked) | Confirm your phone supports eSIM and isn’t locked to another carrier. |
| Error 502 (email in use) | Use a different email to create the account. |
| Error 503 (eSIM limit) | Delete an unused eSIM profile from your device, then retry. |
| Error 504 / 505 | Check your connection and try again; contact T-Mobile if it persists. |
| Error 506 (no numbers in ZIP) | Close and clear the app from recent apps, then reopen and retry. |
Prefer more flexibility? Consider US Mobile
If you’d rather not be locked to one network, US Mobile gives you a choice of all three major U.S. networks (Warp 5G, Dark Star, and Light Speed), with eSIM activation in minutes, no contract, and no activation fee. You can even try it free for 30 days first.
Try US Mobile eSIM free for 30 days
30GB of data on Warp 5G or Dark Star. A payment method is needed to start, but you aren’t charged during the trial.
Start your free trialFrequently Asked Questions
Do I need an unlocked phone to activate a T-Mobile prepaid eSIM?
Yes, if you didn’t buy the phone from T-Mobile it needs to be carrier-unlocked, and it has to support eSIM. Check the eSIM device list if you’re unsure.
Can I move my T-Mobile prepaid eSIM to a new phone?
Yes. Between iPhones you can transfer the number during Quick Start or in settings. Otherwise call T-Mobile with your prepaid eSIM number or Order ID and your account PIN to re-download it.
What does Error 503 mean during activation?
It means your device hit its eSIM profile limit. Delete an unused eSIM profile from your phone’s settings, then try the activation again.
408 Comments