json

{
  "Name": "Jerome User 4",
  "Email": "jerome4@joonto.com",
  "PhoneNumbers": ["+1234567890"],
  "Role": "Subscriber",
  "Password": "1234567890",
  "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}

{
  "SubscriberId": "TSUID-90c644ff-7f70-4587-a27e-d1d45bde7528",
  "Name": "Jerome User 4",
  "Email": "jerome4@joonto.com",
  "PhoneNumbers": [
    "+1234567890"
  ],
  "Role": "Subscriber",
  "Account": {
    "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
    "CompanyName": "Telegent Account"
  }
}

Subscribers

Create Subscriber

Prerequisites:

Required: Bearer token — POST /v1.0/oauth2/tokens
Required: Account ID (AID) — provided by your Telegent representative

Create a new subscriber with name, email, phone numbers, role, and password. Returns the newly created subscriber details.

What this does: Returns the new subscriber’s SubscriberId (TSUID-) and full profile. The TSUID- is required for creating subscriptions, assigning numbers, and configuring AI Guardian. Store it for all subsequent subscriber-related calls.

Next steps:

Assign a subscription — POST /v1.0/subscriptions
Provision a number — POST /v1.0/numbers/provision

POST

v1.0

subscribers

create

json

{
  "Name": "Jerome User 4",
  "Email": "jerome4@joonto.com",
  "PhoneNumbers": ["+1234567890"],
  "Role": "Subscriber",
  "Password": "1234567890",
  "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}

{
  "SubscriberId": "TSUID-90c644ff-7f70-4587-a27e-d1d45bde7528",
  "Name": "Jerome User 4",
  "Email": "jerome4@joonto.com",
  "PhoneNumbers": [
    "+1234567890"
  ],
  "Role": "Subscriber",
  "Account": {
    "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
    "CompanyName": "Telegent Account"
  }
}

Body

application/json

Name

string

required

Subscriber's full name

Example:

"Jerome User 4"

string<email>

required

Subscriber's email address

Example:

"jerome4@joonto.com"

PhoneNumbers

string[]

required

Array of phone numbers associated with subscriber

Example:

["+1234567890"]

Role

enum<string>

required

Role of the subscriber

Available options:

Subscriber,

Manager,

Account Admin

Example:

"Subscriber"

Password

string

required

Password for the subscriber account

Example:

"1234567890"

AccountId

string

required

Account ID to associate subscriber with

Example:

"AID-eab92510-1040-45a5-bb9c-0bad9272f89d"

Response

Success — returns the new Subscriber ID (TSUID-) and account details

The response is of type object.

Get Subscriber Details Update Subscriber

⌘I