Build custom bundles
Bundle Builder lets you design your own eSIM data bundles from scratch. Instead of being limited to the standard catalogue, you can define exactly which countries are covered, how much data is included, how long the bundle is valid for, and which network profile powers it.
Bundle Builder is only available through the eSIM Go portal — there is no API to create or manage custom bundles programmatically. Once a bundle is created, it can be ordered through the standard /orders endpoint like any other bundle.
When to use Bundle Builder
The standard eSIM Go catalogue covers a broad range of ready-made bundles. Bundle Builder is the right choice when you need:
- A specific country combination not available in the standard catalogue
- A data size or duration that doesn’t match any existing option
- An unlimited data bundle with a custom throttle threshold or speed
- A bundle tied to a particular network profile for compatibility or commercial reasons
Creating a bundle
Bundle Builder walks you through four steps. You can navigate back to any step before submitting.
Step 1 — Coverage
Choose the countries where the bundle will be active and select a network profile.
Countries Select one or more countries by name or ISO2 code. There is no fixed upper limit on the number of countries, but the selected countries must all be supported by the chosen network profile.
Network profile eSIM Go operates across several network profiles (Profile 1 through Profile 5), each backed by a different operator partnership. The profile you choose determines:
- Which countries are available for selection
- The data and throttle options available in the next step
- The underlying network your end users will connect to
If a country is not available for a given profile, it will not appear in the country list when that profile is selected.
Step 2 — Data size
Choose how much data the bundle includes.
Fixed data The bundle grants a set amount of data. Enter the size in GB. Once the data is consumed, the bundle is depleted.
- Minimum: 1 GB
- Throttling is not available for fixed bundles
Unlimited data The bundle provides unlimited data. You can optionally apply a throttle once a threshold is reached.
- No throttle: Full-speed data with no cap
- Throttled after X GB: Full-speed data up to a threshold, then speed-limited for the remainder of the bundle period
Throttle options when enabled:
| Setting | Options |
|---|---|
| Throttle speed | 512 kbps, 1.25 Mbps, 2 Mbps |
| Throttle threshold | 0, 1, 2, 3, 5, 10, 20 GB |
Profile-specific constraint: For some network profiles, the throttle threshold cannot be set to 0 GB — a minimum of 1 GB must be consumed before throttling applies. If 0 GB is not available in the threshold selector, this constraint is in effect for the selected profile.
Step 3 — Duration
Set how many days the bundle is valid from the moment it is activated.
- Minimum: 1 day
- Maximum: 60 days
Duration is fixed at creation time and cannot be changed afterwards.
Step 4 — Name and review
Give the bundle a customer-facing name. This is the label your team will use to identify the bundle in the portal and in reports.
Review the summary before confirming. Once submitted, the bundle configuration (countries, size, duration, and profile) is permanent — only the bundle’s availability status can be changed later.
Bundle statuses
Every custom bundle has one of three statuses:
| Status | Meaning |
|---|---|
| Purchasable | The bundle is active and can be ordered via the API |
| Live (not purchasable) | The bundle exists but cannot be ordered; useful for temporarily pausing availability |
| Retired | The bundle has been permanently deactivated by eSIM Go |
You can toggle a bundle between Purchasable and Live (not purchasable) at any time from the bundle list.
The Retired status is managed by eSIM Go and is not something you can set yourself. Retiring a bundle may be introduced as a self-service option in a future update.
Using your custom bundles
Once created, your bundle appears in the catalogue scoped to your organisation. To find its system name, open the bundle detail view in the portal — the name is displayed there and is the identifier to use when ordering.
To order a custom bundle, use the same /orders endpoint as for standard bundles, passing the bundle name in the item field:
{ "type": "transaction", "assign": true, "quantity": 1, "item": "esim_UL_30D_P1_ORG42_R2-A3F7E9C1"}Bundle names are case sensitive.
Limitations
| Constraint | Detail |
|---|---|
| Maximum duration | 60 days |
| Minimum duration | 1 day |
| Throttle speeds | 512 kbps, 1.25 Mbps, or 2 Mbps only |
| Fixed bundle throttling | Not supported — throttling is available for unlimited bundles only |
| Throttle threshold (some profiles) | Minimum 1 GB; 0 GB not available on all network profiles |
| Bundle configuration | Immutable after creation — countries, size, duration, and profile cannot be edited |
| Bundle scope | Custom bundles are visible only within your organisation; they do not appear in the shared catalogue |
Troubleshooting
The country I need is not available Not every country is supported on every network profile. Try switching to a different profile and check whether the country becomes available.
The 0 GB throttle threshold is not selectable This option is not available for all network profiles. Select a threshold of 1 GB or higher, or choose a different profile if the configuration you need is not achievable.
My bundle is not appearing in the catalogue Newly created bundles are available immediately. If a bundle is not appearing, verify its status is set to Purchasable and that you are querying the correct organisation scope.