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",
"ForwardingNumber": "+18015555555"
}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",
"ForwardingNumber": "+18015555555"
}'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",
"ForwardingNumber": "+18015555555"
}
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',
ForwardingNumber: '+18015555555'
})
};
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',
'ForwardingNumber' => '+18015555555'
]),
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 \"ForwardingNumber\": \"+18015555555\"\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 \"ForwardingNumber\": \"+18015555555\"\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 \"ForwardingNumber\": \"+18015555555\"\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",
"ForwardingNumber": "+18015555555"
}{
"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>"
}Numbers
Numbers Update
Update configuration settings for one or more phone numbers. Modify message routes, voice routes, capabilities, and other number attributes. Changes take effect immediately.
What this does: Returns confirmation of the updated number configuration. Changes apply immediately. You can change the message route, voice route, subscriber assignment, or number settings in a single call.
Next steps:
- Confirm the update —
GET /v1.0/numbers - Check inventory —
GET /v1.0/numbers/inventory
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",
"ForwardingNumber": "+18015555555"
}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",
"ForwardingNumber": "+18015555555"
}'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",
"ForwardingNumber": "+18015555555"
}
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',
ForwardingNumber: '+18015555555'
})
};
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',
'ForwardingNumber' => '+18015555555'
]),
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 \"ForwardingNumber\": \"+18015555555\"\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 \"ForwardingNumber\": \"+18015555555\"\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 \"ForwardingNumber\": \"+18015555555\"\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",
"ForwardingNumber": "+18015555555"
}{
"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
Phone number to update (E.164 format)
Example:
"+18018018011"
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"
Enable/disable SMS/MMS capabilities
Example:
true
Message type
Available options:
a2p, p2p Example:
"p2p"
Number classification
Available options:
MVNO, IoT Example:
"MVNO"
Enable/disable voice capabilities
Example:
true
MRID for message routing
Example:
"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee"
CRID for voice routing
Example:
"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe"
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"
SIM card ICCID (for IoT/MVNO)
Example:
"8901240397190556232"
Caller ID first name
Example:
"John"
Caller ID last name
Example:
"Doe"
Product type for the number
Available options:
Sms-Only, Data-Only, Sms+Data, Sms+Data+Voice Example:
"Data-Only"
Number that calls to this line are forwarded to (E.164 format). Send an empty string to clear forwarding.
Example:
"+18015555555"
Response
Numbers Update
The response is of type object.
⌘I