Skip to main content
POST
/
v1.0
/
numbers
/
update
json
{
  "Number": "+18018018011",
  "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
  "MessageEnabled": true,
  "MessageType": "p2p",
  "Classification": "MVNO",
  "VoiceEnabled": true,
  "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
  "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
  "AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
  "Iccid": "8901240397190556232",
  "CnamFirstName": "Test",
  "CnamLastName": "User",
  "ProductType": "Data-Only"
}
curl -X POST https://api.telegent.com/v1.0/numbers/update \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "Number": "+18018018011",
    "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
    "MessageEnabled": true,
    "MessageType": "p2p",
    "Classification": "MVNO",
    "VoiceEnabled": true,
    "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
    "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
    "AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "Iccid": "8901240397190556232",
    "CnamFirstName": "Test",
    "CnamLastName": "User",
    "ProductType": "Data-Only"
  }'
import requests

url = "https://api.telegent.com/v1.0/numbers/update"

payload = {
    "Number": "+18018018011",
    "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
    "MessageEnabled": True,
    "MessageType": "p2p",
    "Classification": "MVNO",
    "VoiceEnabled": True,
    "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
    "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
    "AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "Iccid": "8901240397190556232",
    "CnamFirstName": "John",
    "CnamLastName": "Doe",
    "ProductType": "Data-Only"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    Number: '+18018018011',
    AccountId: 'AID-ab12345-2725-45a1-bd5e-526ed19799xx',
    MessageEnabled: true,
    MessageType: 'p2p',
    Classification: 'MVNO',
    VoiceEnabled: true,
    MessageRouteId: 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
    VoiceRouteId: 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
    AssignedSubscriberId: 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    Iccid: '8901240397190556232',
    CnamFirstName: 'John',
    CnamLastName: 'Doe',
    ProductType: 'Data-Only'
  })
};

fetch('https://api.telegent.com/v1.0/numbers/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.telegent.com/v1.0/numbers/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'Number' => '+18018018011',
    'AccountId' => 'AID-ab12345-2725-45a1-bd5e-526ed19799xx',
    'MessageEnabled' => true,
    'MessageType' => 'p2p',
    'Classification' => 'MVNO',
    'VoiceEnabled' => true,
    'MessageRouteId' => 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
    'VoiceRouteId' => 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
    'AssignedSubscriberId' => 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    'Iccid' => '8901240397190556232',
    'CnamFirstName' => 'John',
    'CnamLastName' => 'Doe',
    'ProductType' => 'Data-Only'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.telegent.com/v1.0/numbers/update"

	payload := strings.NewReader("{\n  \"Number\": \"+18018018011\",\n  \"AccountId\": \"AID-ab12345-2725-45a1-bd5e-526ed19799xx\",\n  \"MessageEnabled\": true,\n  \"MessageType\": \"p2p\",\n  \"Classification\": \"MVNO\",\n  \"VoiceEnabled\": true,\n  \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n  \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n  \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"Iccid\": \"8901240397190556232\",\n  \"CnamFirstName\": \"John\",\n  \"CnamLastName\": \"Doe\",\n  \"ProductType\": \"Data-Only\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.telegent.com/v1.0/numbers/update")
  .header("Content-Type", "application/json")
  .body("{\n  \"Number\": \"+18018018011\",\n  \"AccountId\": \"AID-ab12345-2725-45a1-bd5e-526ed19799xx\",\n  \"MessageEnabled\": true,\n  \"MessageType\": \"p2p\",\n  \"Classification\": \"MVNO\",\n  \"VoiceEnabled\": true,\n  \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n  \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n  \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"Iccid\": \"8901240397190556232\",\n  \"CnamFirstName\": \"John\",\n  \"CnamLastName\": \"Doe\",\n  \"ProductType\": \"Data-Only\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.telegent.com/v1.0/numbers/update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"Number\": \"+18018018011\",\n  \"AccountId\": \"AID-ab12345-2725-45a1-bd5e-526ed19799xx\",\n  \"MessageEnabled\": true,\n  \"MessageType\": \"p2p\",\n  \"Classification\": \"MVNO\",\n  \"VoiceEnabled\": true,\n  \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n  \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n  \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"Iccid\": \"8901240397190556232\",\n  \"CnamFirstName\": \"John\",\n  \"CnamLastName\": \"Doe\",\n  \"ProductType\": \"Data-Only\"\n}"

response = http.request(request)
puts response.read_body
{
  "Number": "+18018018011",
  "Tnid": null,
  "UpdateOrderId": "JNUOID-9ac74103-bf27-474a-8a1a-9f4ff74af187",
  "UpdateOrderDate": "2025-05-14T22:21:08.2813656+00:00",
  "UpdateOrderStatus": "Complete",
  "MessageType": "p2p",
  "MessageEnabled": true,
  "Classification": "MVNO",
  "VoiceEnabled": true,
  "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
  "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
  "Iccid": "8901240397190557414F",
  "CnamFirstName": "John",
  "CnamLastName": "Doe",
  "ProductType": "Data-Only"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}
{
  "StatusCode": 123,
  "Message": "<string>"
}

Body

application/json
​
Number
string
required

Phone number to update (E.164 format)

Example:

"+18018018011"

​
AccountId
string

Account ID (AID) the number belongs to. Required when a distributor account has more than one sub-account.

Example:

"AID-ab12345-2725-45a1-bd5e-526ed19799xx"

​
MessageEnabled
boolean

Enable/disable SMS/MMS capabilities

Example:

true

​
MessageType
enum<string>

Message type

Available options:
a2p,
p2p
Example:

"p2p"

​
Classification
enum<string>

Number classification

Available options:
MVNO,
IoT
Example:

"MVNO"

​
VoiceEnabled
boolean

Enable/disable voice capabilities

Example:

true

​
MessageRouteId
string

MRID for message routing

Example:

"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee"

​
VoiceRouteId
string

CRID for voice routing

Example:

"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe"

​
AssignedSubscriberId
string

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.

Example:

"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d"

​
Iccid
string

SIM card ICCID (for IoT/MVNO)

Example:

"8901240397190556232"

​
CnamFirstName
string

Caller ID first name

Example:

"John"

​
CnamLastName
string

Caller ID last name

Example:

"Doe"

​
ProductType
enum<string>

Product type for the number

Available options:
Sms-Only,
Data-Only,
Sms+Data,
Sms+Data+Voice
Example:

"Data-Only"

Response

Numbers Update

The response is of type object.