- [Support](https://www.t-mobile.com/support)
- [Get started](#)
- [New to T-Mobile?](https://www.t-mobile.com/support/new-to-tmobile)
[Switching is easy](https://www.t-mobile.com/support/new-to-tmobile/family-freedom)
[Set up your device](https://www.t-mobile.com/support/new-to-tmobile/device)
[Using the app](https://www.t-mobile.com/support/plans-features/t-mobile-app)
[All get started topics](https://www.t-mobile.com/support/new-to-tmobile)
- [Account resources](#)
- [Ways to pay your bill](https://www.t-mobile.com/support/account/pay-your-bill)
[All about your bill](https://www.t-mobile.com/support/account/whats-impacting-your-bill)
[Line permissions](https://www.t-mobile.com/support/account/set-online-permissions)
[Your T-Mobile ID](https://www.t-mobile.com/support/account/set-up-and-manage-your-t-mobile-id)
[Your PIN/Passcode](https://www.t-mobile.com/support/account/update-your-customer-pinpasscode)
[All account resources topics](https://www.t-mobile.com/support/account)
- [Network & roaming](#)
- [T-Mobile network](https://www.t-mobile.com/support/coverage/t-mobile-network)
[In-flight texting and Wi-Fi](https://www.t-mobile.com/support/coverage/t-mobile-in-flight-texting-and-wi-fi)
[Wi-Fi Calling](https://www.t-mobile.com/support/coverage/wi-fi-calling-from-t-mobile)
[International roaming](https://www.t-mobile.com/support/coverage/international-roaming-services)
[Mobile Without Borders](https://www.t-mobile.com/support/coverage/mobile-without-borders)
[All network & roaming topics](https://www.t-mobile.com/support/coverage)
- [Plans support](#)
- [Find the right plan](https://www.t-mobile.com/support/plans-features/find-the-right-plan-for-you)
[Netflix on Us](https://www.t-mobile.com/support/plans-features/netflix-on-us)
[HotSpot plans](https://www.t-mobile.com/support/plans-features/mobile-internet-plans-for-hotspots)
[Voicemail](https://www.t-mobile.com/support/plans-features/voicemail)
[Use Mobile HotSpot](https://www.t-mobile.com/support/plans-features/smartphone-mobile-hotspot-wi-fi-sharing--tethering)
[All plans support topics](https://www.t-mobile.com/support/plans-features)
- [Device assistance](#)
- [Tutorials](https://www.t-mobile.com/support/tutorials)
[Troubleshooting](https://www.t-mobile.com/support/phones-tablets-devices/troubleshooting)
[Unlock your device](https://www.t-mobile.com/support/devices/unlock-your-mobile-wireless-device)
[Protect your device](https://www.t-mobile.com/support/devices/protectionandlt360andgt-and-device-protection)
[SIM card & eSIM](https://www.t-mobile.com/support/devices/sim-esim)
[All device assistance topics](https://www.t-mobile.com/support/phones-tablets-devices)
- [Business support](#)
- [Get T-Mobile for Business](https://www.t-mobile.com/support/business/new-to-business)
[Billing and payments](https://www.t-mobile.com/support/business/billing)
[Manage your account](https://www.t-mobile.com/support/business/account)
[Orders and shopping](https://www.t-mobile.com/support/business/orders-shopping)
[Account Hub registration](https://www.t-mobile.com/support/business/account-hub-registration)
[All business support topics](https://www.t-mobile.com/support/business)
[SUPPORT](https://www.t-mobile.com/support)
- [Get started](#)
- [New to T-Mobile?](https://www.t-mobile.com/support/new-to-tmobile)
- [Switching is easy](https://www.t-mobile.com/support/new-to-tmobile/family-freedom)
- [Set up your device](https://www.t-mobile.com/support/new-to-tmobile/device)
- [Using the app](https://www.t-mobile.com/support/plans-features/t-mobile-app)
- [All get started topics](https://www.t-mobile.com/support/new-to-tmobile)
- [Account resources](#)
- [Ways to pay your bill](https://www.t-mobile.com/support/account/pay-your-bill)
- [All about your bill](https://www.t-mobile.com/support/account/whats-impacting-your-bill)
- [Line permissions](https://www.t-mobile.com/support/account/set-online-permissions)
- [Your T-Mobile ID](https://www.t-mobile.com/support/account/set-up-and-manage-your-t-mobile-id)
- [Your PIN/Passcode](https://www.t-mobile.com/support/account/update-your-customer-pinpasscode)
- [All account resources topics](https://www.t-mobile.com/support/account)
- [Network & roaming](#)
- [T-Mobile network](https://www.t-mobile.com/support/coverage/t-mobile-network)
- [In-flight texting and Wi-Fi](https://www.t-mobile.com/support/coverage/t-mobile-in-flight-texting-and-wi-fi)
- [Wi-Fi Calling](https://www.t-mobile.com/support/coverage/wi-fi-calling-from-t-mobile)
- [International roaming](https://www.t-mobile.com/support/coverage/international-roaming-services)
- [Mobile Without Borders](https://www.t-mobile.com/support/coverage/mobile-without-borders)
- [All network & roaming topics](https://www.t-mobile.com/support/coverage)
- [Plans support](#)
- [Find the right plan](https://www.t-mobile.com/support/plans-features/find-the-right-plan-for-you)
- [Netflix on Us](https://www.t-mobile.com/support/plans-features/netflix-on-us)
- [HotSpot plans](https://www.t-mobile.com/support/plans-features/mobile-internet-plans-for-hotspots)
- [Voicemail](https://www.t-mobile.com/support/plans-features/voicemail)
- [Use Mobile HotSpot](https://www.t-mobile.com/support/plans-features/smartphone-mobile-hotspot-wi-fi-sharing--tethering)
- [All plans support topics](https://www.t-mobile.com/support/plans-features)
- [Device assistance](#)
- [Tutorials](https://www.t-mobile.com/support/tutorials)
- [Troubleshooting](https://www.t-mobile.com/support/phones-tablets-devices/troubleshooting)
- [Unlock your device](https://www.t-mobile.com/support/devices/unlock-your-mobile-wireless-device)
- [Protect your device](https://www.t-mobile.com/support/devices/protectionandlt360andgt-and-device-protection)
- [SIM card & eSIM](https://www.t-mobile.com/support/devices/sim-esim)
- [All device assistance topics](https://www.t-mobile.com/support/phones-tablets-devices)
- [Business support](#)
- [Get T-Mobile for Business](https://www.t-mobile.com/support/business/new-to-business)
- [Billing and payments](https://www.t-mobile.com/support/business/billing)
- [Manage your account](https://www.t-mobile.com/support/business/account)
- [Orders and shopping](https://www.t-mobile.com/support/business/orders-shopping)
- [Account Hub registration](https://www.t-mobile.com/support/business/account-hub-registration)
- [All business support topics](https://www.t-mobile.com/support/business)
[Support](https://www.t-mobile.com/support/) [Plans & features](https://www.t-mobile.com/support/community/plans-features)
# T-Mobile Prepaid eSIM app
0
Added!
[](https://www.t-mobile.com)
### Manage Links
Click any [available links](https://www.t-mobile.com) to add.
Click any [added links](https://www.t-mobile.com) to remove.
Links with [no highlight](https://www.t-mobile.com) can't be sent.
Done (0 Links)
The T-Mobile Prepaid eSIM app lets you activate new T-Mobile prepaid service on an iPhone or Android with eSIM. For other devices, check the compatibility to [bring your device to T-Mobile Prepaid](https://prepaid.t-mobile.com/bring-your-own-device).
Looking for Prepaid plans and devices? Visit the [T-Mobile Prepaid website](https://prepaid.t-mobile.com).
## On this page:
- [About the app](https://www.t-mobile.com#app1)
- [Activate T-Mobile service](https://www.t-mobile.com#app2)
- [Re-download eSIM](https://www.t-mobile.com#app3)
- [Errors and support](https://www.t-mobile.com#app4)
- [Full terms](https://www.t-mobile.com#app5)
## [](https://www.t-mobile.com)About the app
The Prepaid eSIM app was built for travelers coming to the U.S., existing T-Mobile customers who want a secondary pre-paid line, and anyone who wants to take the Un-carrier out for a test drive to try out America’s fastest 5G network.*
- The app can *only* activate a T-Mobile prepaid line.
- For postpaid accounts, check out [T-Mobile eSIM](https://www.t-mobile.com/support/devices/sim-esim).
- Only available for iPhone or Android devices with eSIM.
- The app requires:
- You have a data connection, through either Wi-Fi or Cellular.
- You either purchased the device from T-Mobile, or else you must first SIM unlock it. (Contact the original provider if you need help.)
- There are no fees to activate a device with an eSIM.
- You must be located in the US when activating service.
- To activate your eSIM on another wireless provider or manage eSIM settings, check out our [Tutorials](https://www.t-mobile.com/support/tutorials).
## [](https://www.t-mobile.com)Activate T-Mobile service
1. Download the T-Mobile Prepaid eSIM app:
- [Apple App Store](https://apps.apple.com/us/app/t-mobile-esim/id1437014693)
- [Google Play Store](https://play.google.com/store/apps/details?id=com.tmo.esim&hl=en_US&gl=US)
2. Open the app and choose what type of plans to explore:
- __See travel plans__ shows limited duration plans designed for travelers
- __Explore other plans__ shows plans other than travel
3. Enter the following information, then choose __Next:__
- Email addresss
- 6-15 digit PIN
- Your U.S. ZIP code
4. If prompted, allow the app access to your location while you’re using the app.
5. Review your order to make sure everything looks correct.
6. Enter your Credit Card informaiton, including CVV and billing ZIP code, then select __Place order__.
7. Wait while we set up your T-Mobile service.
8. Follow the prompts on your device to complete your eSIM download, including giving it a name and choosing a primary line.
9. If you want to use a phone number from another provider or from another line, [contact us](https://www.t-mobile.com/support/community/contact-us.html) to get this started.
## [](https://www.t-mobile.com)Re-download eSIM
Sometimes, you may need to replace the eSIM you received through the app.
- You accidentally deleted your eSIM.
- You upgraded your phone and want to transfer your eSIM line of service to your new phone.
- You lost connection when downloading your eSIM, and it didn't get installed properly on your device.
If you’re switching from one iPhone to another, you can transfer your phone number during [Quick Start](https://www.t-mobile.com/support/tutorials/device/apple/iphone-14-pro/topic/esim/transferring-an-esim-using-quick-start) or through [device settings](https://www.t-mobile.com/support/tutorials/device/apple/iphone-14-pro/topic/esim/transferring-an-esim-using-manual-setup). Otherwise, you'll need to call us at [1-877-778-2106](tel:1-877-778-2106). Make sure you have:
- Your Prepaid eSIM phone number or your OrderID. Your OrderID will display if you encounter an error in the app.
- Your account PIN code, which you set up to complete your order in the T-Mobile Prepaid eSIM App.
## [](https://www.t-mobile.com)Errors and support
Here are some error messages you may receive using the app and tips to solve them.
### Something went wrong – Check your internet connection
- This means the app lost its connection to the internet when trying to set up service.
- Make sure you have good Wi-Fi or Cellular signal, then try again.
- If possible, try again using a different Wi-Fi network.
### Looks like your device isn’t compatible
- This means your device doesn't have an eSIM or is locked to the service provider you purchased it from.
- If you have an iPhone, make sure it's the Apple iPhone Xs or newer.
- If you have a Samsung, make sure it [supports eSIM](https://www.samsung.com/au/support/mobile-devices/esim-compatibility/).
- Contact the service provider who sold you the device to request an unlock.
### This email address is already in use. Try a different email
- This means the email address you're trying to use is already set up with an existing T-Mobile account.
- Try again with a different email address to create a new account.
### Error 504: Oops, something went wrong
- This means that the app had an issue loading the next screen.
- Make sure you have a strong Wi-Fi or Cellular data connection, then try again.
- If it's still not working, [contact us](https://www.t-mobile.com/contact-us) for help.
### Error 505: There was an issue completing your order
- This means there was an issue processing your payment.
- You can try again with a different payment method.
- If you’re currently outside of the United States, try again when you arrive.
- If it's still not working, [contact us](https://www.t-mobile.com/contact-us) for help.
## [](https://www.t-mobile.com)Full terms
\*5G: Capable device required; coverage not available in some areas. Some uses may require certain plan or feature; see T-Mobile.com. Fastest: Based on median, overall combined 5G speeds according to analysis by Ookla® of Speedtest Intelligence® data for Q2 2023.
Travel Plans: Limited time; subject to change. Plus taxes & fees. See Broadband Facts at T-Mobile.com. Capable device required. During congestion, heavy data users (>50GB/mo.) may notice lower speeds than other customers due to data prioritization. Video streams in SD.
7 Day Plan: Includes 14GB of high-speed Mobile HotSpot, then unlimited at 3G speeds. Includes 200MB domestic roaming. Unlimited talk & text features for direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra. Features available until 7th day only.
10 Day Plan: Includes 20GB of high-speed Mobile HotSpot, then unlimited at 3G speeds. Includes 200MB domestic roaming. Unlimited talk & text features for direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra. Features available until 10th day only.
14 Day Plan: Includes 28GB of high-speed Mobile HotSpot, then unlimited at 3G speeds. Includes 200MB domestic roaming. Unlimited talk & text features for direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra. Features available until 14th day only.
30 Day Plan: Includes 50GB of high-speed Mobile HotSpot, then unlimited at 3G speeds. Includes 200MB domestic roaming. Unlimited talk & text features for direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra. Features available until 30th day only.
International Services Tourist Plans: Not for extended international use; you must reside in the U.S. and primary usage must occur on our network. Unlimited high-speed data in US only. Device must register on our network before international use. Service may be terminated or restricted for excessive roaming. Coverage not available in some areas; we are not responsible for our partners’ networks. 7, 10 & 14 day Plans. Additional charges apply for international use. Includes unlimited calling and texting between Canada, Mexico, and U.S. and up to 5GB of high speed data (including any available HotSpot data) in Canada & Mexico then unlimited at up to 128kbps at no extra cost with US Pass eSIM Can/Mex Data Add on. 30 day Tourist Plans. Additional charges apply for international use. Includes unlimited calling and texting between Canada, Mexico, and U.S. and up to 5GB of high speed data in Canada & Mexico then unlimited at up to 128kbps. $15 Stateside International Add-On: Stay connected with calls from the US and North America with Stateside International Talk. International calling from U.S./Canada/Mexico to landlines in over 70 countries and destinations, plus unlimited calling to mobiles in over 30 countries. Qualifying service required. Calls must originate on our U.S. network or in Canada/Mexico; otherwise international roaming rates apply. Must be direct communication between 2 people; certain numbers not included. See t-mobile.com for countries and rates; subject to change at our discretion.
Tourist Plans General Terms: If sufficient balance, services automatically renew at expiration. If balance is insufficient to renew all lines on your account for 120 days, all lines will be suspended for 30 days. If you have an account balance, all lines will convert to Pay As You Go for 30 day increments with $3/mo. for 30 voice min./SMS messages. If funds available, additional minutes/messages @ $0.10/minute or message. After your account balance is depleted, then account is suspended. When you switch between plan options or renew a monthly plan, features or credits associated with your prior plan option will no longer be available, and you are not able to switch back to some plan options. Some plan options will not allow early renewal or permit use of features after included amounts are depleted. If you transfer your number to another carrier, account will be deactivated and no service will be available. Void if not activated within 90 days from purchase. No cash redemption value. Non-refundable. Video streams at up to 2.5Mbps with Data Maximizer. Optimization may affect speed of video downloads. For best performance, leave any video streaming applications at their default automatic resolution setting. HD video passes available; purchase and activate to experience HD resolution (capable device required). Some content providers may not stream their services in HD. Not available for hotspots and some other data-first devices. Network Management: For customers using over 50GB per month, primary data usage must be on smartphone or tablet. Scam Shield might block calls you want; disable any time.
Unlimited Plans:
Limited time; subject to change. Plus taxes and fees. See Broadband Facts at T-Mobile.com. Capable device required. During congestion, heavy data users (>50GB/mo. on most plans; >15GB/mo. on Starter Monthly plan) may notice lower speeds than other customers due to data prioritization. Video streams in SD.
Starter Monthly: Unlimited talk & text. 15GB high speed data. Partial minutes/megabytes rounded up. Full speeds available up to data allotment, including tethering; then slowed to up to 2G speeds for balance of service period. Certain uses, e.g., some speed test apps, may count against high-speed data allotment or have speeds reduced after allotment reached. Includes 100MB domestic roaming.
Unlimited Monthly: Unlimited talk, text, and data. Tethering at max 3G speeds. Includes 200MB domestic roaming. HD Day Pass available; purchase and activate to experience HD resolution (capable device required). Unlimited high-speed data US only. Not available for hotspots and some other data-first devices. For customers using over 50 GB per month, primary data usage must be on smartphone or tablet.
Unlimited Monthly Plus: Unlimited talk, text, and data. Up to 5GB high-speed tethering then unlimited on our network at max 3G speeds. Includes 200MB domestic roaming. Int’l Services: Includes unlimited texting from U.S. to 200+ countries and destinations; see details at T-Mobile.com. Includes unlimited calling and texting between Canada, Mexico, and U.S. Not for extended international use; you must reside in the U.S. and primary usage must occur on our network. We are not responsible for the coverage of our roaming partners. HD Day Pass available; purchase and activate to experience HD resolution (capable device required). Unlimited high-speed data US only. Not available for hotspots and some other data-first devices. For customers using over 50 GB per month, primary data usage must be on smartphone or tablet.
Monthly Plans General terms: Autopay discount applies to month after enrollment; debit card or bank account required. Without Autopay, $5 more/account. Capable device required for some features. Includes 100MB domestic roaming. Unlimited talk & text features for direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra. Features available until 30th day; if sufficient balance, services automatically renew at expiration. If balance is insufficient to renew all lines on your account for 120 days, all lines will be suspended for 30 days. If you have an account balance, all lines will convert to Pay As You Go for 30 day increments with $3/mo. for 30 voice min./SMS messages. If funds available, additional minutes/messages @ $0.10/minute or message. After your account balance is depleted, then account is suspended. When you switch between plan options or renew a monthly plan, features or credits associated with your prior plan option will no longer be available, and you are not able to switch back to some plan options. Some plan options will not allow early renewal or permit use of features after included amounts are depleted. If you transfer your number to another carrier, account will be deactivated and no service will be available. Void if not activated within 90 days from purchase. No cash redemption value. Non-refundable. Additional charges apply for international use. Not for extended international use; you must reside in the U.S. and primary usage must occur on our network. Video streams at up to 2.5Mbps with Data Maximizer. Optimization may affect speed of video downloads; does not apply to video uploads. For best performance, leave any video streaming applications at their default automatic resolution setting. Coverage not available in some areas; we are not responsible for our partners’ networks. Scam Shield: Capable device req’d. Turning on Scam Block might block calls you want; disable any time. Coverage not available in some areas. Network Management: Service may be slowed, suspended, terminated, or restricted for misuse, abnormal use, interference with our network or ability to provide quality service to other users, or significant roaming. On-device usage is prioritized over tethering usage, which may result in higher speeds for data used on device. See T-Mobile.com/OpenInternet for details.
Limited Plans:
Limited-time offer; subject to change. Plus taxes and fees. Not eligible for AutoPay discount. Capable device required. Domestic use only. Video typically streams in SD quality.
5GB Plan: Unlimited talk and text. Includes 5GB of 5G data.
8GB Plan: Unlimited talk and text. Includes 8GB of 5G data.
12GB Plan: Unlimited talk and text. Includes 12GB of 5G data.
Connect Plans General Term: U.S. roaming and on-network data allotments differ; includes 100MB roaming. Talk & text features for basic direct communications between 2 people; others (e.g., conference, chat lines, iMessage) may cost extra or require data allotment. Partial minutes/megabytes rounded up. Full speeds available to data allotment, including tethering; then data access is not available until next bill cycle. Features available until 30th day; if sufficient balance, services automatically renew at expiration. If balance is insufficient to renew all lines on your account for 120 days, all lines will be suspended for 30 days. If you have an account balance, all lines will convert to Pay As You Go for 30 day increments with $3/mo. for 30 voice min./SMS messages. After your account balance is depleted, then account is suspended. When you switch between plan options or renew a monthly plan, features or credits associated with your prior plan option will no longer be available, and you are not able to switch back to some plan options. Some plan options will not allow early renewal or permit use of features after included amounts are depleted. If you transfer your number to another carrier, account will be deactivated and no service will be available. Video streams at up to 2.5Mbps (SD) with Data Maximizer. Disable Data Maximizer at any time. Optimization may affect speed of video downloads; does not apply to video uploads. For best performance, leave any video streaming applications at their default automatic resolution setting. Partial megabytes rounded up. Smartphone and tablet usage is prioritized over Mobile Hotspot Service (tethering) usage, which may result in higher speeds for data used on smartphones and tablets. Certain uses, e.g., some speed test apps, may count against high-speed data allotment. Void if not activated within 90 days from purchase. No cash redemption value. Non-refundable. Devices sold for use on T-Mobile prepaid service are to be activated on that service, not transferred for resale, modification, or export.
All Plans: See Terms and Conditions (including arbitration provision) at www.T-Mobile.com or additional information. T-Mobile, the T logo, Magenta and the magenta color are registered trademarks of Deutsche Telekom AG. © 2026 T-Mobile USA, Inc.
* * *
Was this helpful?
* * *
## Can't find what you're looking for?
- [Contact Us](https://www.t-mobile.com/contact-us)
- [Ask our community](https://www.t-mobile.com/community/)