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
.
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:
In addition to configuring the APN on your device, you need to ensure that you have roaming enabled.
The Twilio APN does not require any authentication, so you should always leave username and password fields blank .
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:
AT+CGDCONT=1,"IP","super"
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 .
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:
1curl -X POST https://supersim.twilio.com/v1/SmsCommands \2-d 'Sim=AliceSmithSmartMeter' \3-d 'Payload=AT+CGDCONT=1,"IP","super"' \4-d 'CallbackUrl=https://example.com/api' \5-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.
1twilio api:supersim:v1:sms-commands:create \2--sim AliceSmithSmartMeter \3--payload 'AT+CGDCONT=1,"IP","super"' \4--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:
1HTTP/1.1 202 ACCEPTED2Content-Type: application/json34{5"sid": "HCxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",6"sim_sid": "HSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",7"payload": "AT+CGDCONT=1,\"IP\",\"super\"",8"status": "queued",9"date_created": "2019-05-23T15:42:04Z",10"date_updated": "2019-05-23T15:42:04Z",11"account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",12"url": "https://supersim.twilio.com/v1/SmsCommands/HCxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"13}
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.
Whatever version of Android you are using, you set the APN broadly like this:
Twilio
under
Name
and enter
super
under
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.
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.
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.
MCC | MNC | MVNO Type | MVNO Value | APN |
---|---|---|---|---|
232 | 10 | SPN | Twilio | super |
234 | 10 | SPN | Twilio | super |
234 | 50 | SPN | Twilio | super |
732 | 123 | SPN | Twilio | super |
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.
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 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.
super
.
You can find more information about viewing and editing APNs in iPhones and iPads on this Apple support page.
You will know your device is correctly configured if you can send and receive data. Try pinging www.twilio.com, or open your favorite web browser and navigate to www.twilio.com/wireless/super-sim.
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.