Create Subscription
Prerequisites:
- Required: Bearer token —
POST /v1.0/oauth2/tokens - Required: Package ID (PID) —
POST /v1.0/packages - Required: Subscriber ID (TSUID) —
POST /v1.0/subscribers/create
Link a subscriber to a package to grant them access to a set of services. A subscription ties together a subscriber (TSUID), a package (PID), and optionally a phone number (TNID) and SIM card (ICCID). The subscriber, package, and phone number must all exist before creating the subscription. Active subscriptions determine what services and capabilities are available to the subscriber.
What this does: Returns the new SubscriptionId (SUB-) and full subscription record. Creating a subscription links the subscriber to a package, granting them the services and capabilities defined in that package.
Next steps:
- Confirm the subscription —
GET /v1.0/subscriptions - View the package contents —
GET /v1.0/packages/items
Query Parameters
Body
Telegent Subscriber ID. Format: TSUID- followed by a UUID. Create one via POST /v1.0/subscribers/create or look up existing IDs with GET /v1.0/subscribers/get.
"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d"
Package ID to subscribe to
"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db"
Subscription type
"mvno"
Telephone Number ID
"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6"
SIM Card ICCID
"8901240397190002080"
Response
Success — returns the new Subscription ID (SUB-) and associated details
The response is of type object.