Skip to contentSkip to navigationSkip to topbar
Rate this Page:

How to Set a Device’s APN for Super SIM



What is the Super SIM APN?

what-is-the-super-sim-apn page anchor

super

de1.super

sg1.super

You will need to configure the device into which you have fitted your Super SIM with the identity of the server through which it will transfer data. This is the SIM's configured Access Point Name (APN). Super SIM's default APN and distributed Internet breakout APNs are shown above.

Support for distributed Internet breakouts are now available to all customers. Using a distributed breakout is key to achieving low latency. We offer a breakout in Frankfurt for Super SIM customers in Europe and Africa, and another breakout in Singapore for Super SIM customers in Asia Pacific. More locations will follow.

The APN you use determines your breakout point. The default APN, super, causes traffic to break out to the Internet from the Twilio Mobile Core in Ashburn, Virginia in the US. To make use of the Frankfurt breakout, set your device's APN to de1.super instead of super. To make use of the Singapore breakout, set your device's APN to sg1.super rather than super.


How to set your device's APN

how-to-set-your-devices-apn page anchor

If you know how to configure the APN on your device, go ahead and make the change now. If not, here are some guides to help you:

  • If you are using an IoT device that supports AT Commands, see here for details .
  • If you are using an Android device, see here for details .
  • If you are using an iOS device, see here for details .

In addition to configuring the APN on your device, you need to ensure that you have roaming enabled.

(warning)

Warning

The Twilio APN does not require any authentication, so you should always leave username and password fields blank .


How do I set the APN with AT Commands?

how-do-i-set-the-apn-with-at-commands page anchor

Refer to your device's user manual to learn how to use AT commands, then issue the following command to your device's cellular modem:


_10
AT+CGDCONT=1,"IP","super"

(information)

Info

If you need to check that a given device contains a Super SIM in order to apply the correct APN, please see How To determine Whether a Device Contains a Super SIM .

Setting the APN with AT commands via SMS

setting-the-apn-with-at-commands-via-sms page anchor

If you're using a device that allows sending AT commands via SMS, you can use our SMS Commands API resource to send a machine-to-machine SMS to the Super SIM. You can use a command line tool such as curl or the Twilio CLI to transmit an API request which contains the AT command shown above.

In this example, AliceSmithSmartMeter is the unique name of the SIM as set in Console. The AT command you use to set the APN is included in the Command field.

The optional CallbackUrl field takes an endpoint on your server to which Twilio will send the final response once roaming has been enabled; the initial request will generate a 200 OK response on the successful receipt of the request, or an error if the request was malformed. If an error is reported, the callback will not be triggered.

Here is the initial request, made via curl and containing the APN-setting AT command:


_10
curl -X POST https://supersim.twilio.com/v1/SmsCommands \
_10
-d 'Sim=AliceSmithSmartMeter' \
_10
-d 'Payload=AT+CGDCONT=1,"IP","super"' \
_10
-d 'CallbackUrl=https://example.com/api' \
_10
-u 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:your_auth_token'

Here is the same request but this time made with the Twilio CLI. The --sim option's argument is the Super SIM's SID.


_10
twilio api:supersim:v1:sms-commands:create \
_10
--sim AliceSmithSmartMeter \
_10
--payload 'AT+CGDCONT=1,"IP","super"' \
_10
--callback-url https://example.com/api

The request will cause the following response to be posted to the optional callback URL. The sid, sim_sid, account_sid, and url fields will contain true values:


_13
HTTP/1.1 202 ACCEPTED
_13
Content-Type: application/json
_13
_13
{
_13
"sid": "HCxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
_13
"sim_sid": "HSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
_13
"payload": "AT+CGDCONT=1,\"IP\",\"super\"",
_13
"status": "queued",
_13
"date_created": "2019-05-23T15:42:04Z",
_13
"date_updated": "2019-05-23T15:42:04Z",
_13
"account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
_13
"url": "https://supersim.twilio.com/v1/SmsCommands/HCxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
_13
}

(warning)

Warning

Many devices do not support setting the APN via SMS. Refer to your device's user manual to see if this action is permitted and how to format the message.


Where do I set the APN on my Android device?

where-do-i-set-the-apn-on-my-android-device page anchor

Whatever version of Android you are using, you set set the APN broadly like this:

  1. Go to Settings > More settings > Cellular networks > Access point names .
  2. Tap the menu or + icon to edit an access point.
  3. Enter Twilio under Name and enter super under APN .
  4. Tap your new Twilio APN to set it as your active APN.

Subtle differences between Android versions mean that you may not see UI elements with exactly the same names as those shown above, but they will be similar.

Adding an APN with MCC and MNC values

adding-an-apn-with-mcc-and-mnc-values page anchor

Some versions of Android require you to provide a Mobile Country Code (MCC) and Mobile Network Code (MNC) for an APN. This is to help match the APN to the IMSI being used by the device. Every Super SIM has multiple IMSIs that it will switch between depending on the country in which the device has been deployed, or whether or not it has been able to connect in the past. To ensure that you can connect with any of the IMSIs used, please add all of the following APN and MCC-MNC combinations to your device.

(warning)

Warning

As you enter each of these values, they may be immediately hidden by Android and so you will not see them. You must enter all four of these entries to ensure proper operation.

MCCMNCMVNO TypeMVNO ValueAPN
23210SPNTwiliosuper
23410SPNTwiliosuper
23450SPNTwiliosuper
732123SPNTwiliosuper

You can also enter SPN for the APN's MVNO Type setting and Twilio for the MVNO Value setting. By adding these MVNO (Mobile Virtual Network Operator) settings, Android will be able to correctly select the APN without having to prompt the user.


Where do I set the APN on my iOS device?

where-do-i-set-the-apn-on-my-ios-device page anchor
(error)

Danger

Every Super SIM has multiple IMSIs that it will switch between depending on the country in which the device is being used. For some IMSIs, iOS, particularly on iPhones, may prevent you from changing from the APN. If you cannot change the APN to super you will not be able to use data. Tools like Apple Configurator(link takes you to an external page) can help you get around this limitation if iOS is preventing you from setting the APN: you'll find our guidance here.

The process for setting the APN depends on which version of iOS your device has.

  1. If the system language is English (US/Canada), go to Settings > Cellular > Cellular Data Network .
  2. If the system language is English (UK), go to Settings > Mobile Data > Mobile Data Network .
  3. For other languages, use the appropriate menu path.
  4. Tap APN and enter super .
  5. Leave the Username and Password fields blank.
(information)

Info

You can find more information about viewing and editing APNs in iPhones and iPads on this Apple support page(link takes you to an external page).


Verify you're connected to the network

verify-youre-connected-to-the-network page anchor

You will know your device is correctly configured if you can send and receive data. Try pinging www.twilio.com(link takes you to an external page), or open your favorite web browser and navigate to www.twilio.com/wireless/super-sim(link takes you to an external page).

If your ping is unsuccessful or if you cannot load the web page, review the instructions above and make sure you have also enabled roaming on your device.


Rate this Page: