json
{
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": true,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": true,
"OutboundBypass": true,
"IntelligentRouteEnabled": true,
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}curl -X POST https://api.telegent.com/v1.0/message/routes \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": true,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": true,
"OutboundBypass": true,
"IntelligentRouteEnabled": true,
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}'import requests
url = "https://api.telegent.com/v1.0/message/routes"
payload = {
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": True,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": True,
"OutboundBypass": True,
"IntelligentRouteEnabled": True,
"AccountId": "DID-eab92510-1040-45a5-bb9c-0bad927SDY878W"
}
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({
RouteName: 'Main SMS Webhook',
MessageUrl: 'https://apiendpoint.com',
MessageUrlMethod: 'POST',
MessageRouteEnabled: true,
MessageAuthenticationType: 'Basic',
MessageUsername: 'admin',
MessagePasswordToken: 'passwordORbearerToken',
CallbackMessageUrl: 'https://apiendpoint.com',
CallbackMessageUrlMethod: 'POST',
CallbackMessageAuthenticationType: 'Basic',
CallbackMessageUsername: 'admin',
CallbackMessagePasswordToken: 'password',
InboundBypass: true,
OutboundBypass: true,
IntelligentRouteEnabled: true,
AccountId: 'DID-eab92510-1040-45a5-bb9c-0bad927SDY878W'
})
};
fetch('https://api.telegent.com/v1.0/message/routes', 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/message/routes",
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([
'RouteName' => 'Main SMS Webhook',
'MessageUrl' => 'https://apiendpoint.com',
'MessageUrlMethod' => 'POST',
'MessageRouteEnabled' => true,
'MessageAuthenticationType' => 'Basic',
'MessageUsername' => 'admin',
'MessagePasswordToken' => 'passwordORbearerToken',
'CallbackMessageUrl' => 'https://apiendpoint.com',
'CallbackMessageUrlMethod' => 'POST',
'CallbackMessageAuthenticationType' => 'Basic',
'CallbackMessageUsername' => 'admin',
'CallbackMessagePasswordToken' => 'password',
'InboundBypass' => true,
'OutboundBypass' => true,
'IntelligentRouteEnabled' => true,
'AccountId' => 'DID-eab92510-1040-45a5-bb9c-0bad927SDY878W'
]),
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/message/routes"
payload := strings.NewReader("{\n \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\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/message/routes")
.header("Content-Type", "application/json")
.body("{\n \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/message/routes")
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 \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\n}"
response = http.request(request)
puts response.read_body{
"MessageRouteId": "MRID-ad0ff867-57dc-4aeb-80e9-9d18349080e9",
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": false,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password"
}{
"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>"
}Message
Create Message Route
Create a new message route to configure how inbound SMS/MMS messages are handled. Specify webhook URLs for message delivery, fallback URLs, and HTTP methods. Each route is identified by a unique MRID (Message Route ID).
What this does: Returns the new route’s MessageRouteId (MRID-). Store this ID — it is required when provisioning numbers and can be assigned to multiple numbers. The webhook URL you configure receives a POST for every inbound message on numbers using this route.
Next steps:
- Assign the route to a number at provision time —
POST /v1.0/numbers/provision - Update route settings —
POST /v1.0/message/routes/update
POST
/
v1.0
/
message
/
routes
json
{
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": true,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": true,
"OutboundBypass": true,
"IntelligentRouteEnabled": true,
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}curl -X POST https://api.telegent.com/v1.0/message/routes \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": true,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": true,
"OutboundBypass": true,
"IntelligentRouteEnabled": true,
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx"
}'import requests
url = "https://api.telegent.com/v1.0/message/routes"
payload = {
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": True,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password",
"InboundBypass": True,
"OutboundBypass": True,
"IntelligentRouteEnabled": True,
"AccountId": "DID-eab92510-1040-45a5-bb9c-0bad927SDY878W"
}
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({
RouteName: 'Main SMS Webhook',
MessageUrl: 'https://apiendpoint.com',
MessageUrlMethod: 'POST',
MessageRouteEnabled: true,
MessageAuthenticationType: 'Basic',
MessageUsername: 'admin',
MessagePasswordToken: 'passwordORbearerToken',
CallbackMessageUrl: 'https://apiendpoint.com',
CallbackMessageUrlMethod: 'POST',
CallbackMessageAuthenticationType: 'Basic',
CallbackMessageUsername: 'admin',
CallbackMessagePasswordToken: 'password',
InboundBypass: true,
OutboundBypass: true,
IntelligentRouteEnabled: true,
AccountId: 'DID-eab92510-1040-45a5-bb9c-0bad927SDY878W'
})
};
fetch('https://api.telegent.com/v1.0/message/routes', 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/message/routes",
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([
'RouteName' => 'Main SMS Webhook',
'MessageUrl' => 'https://apiendpoint.com',
'MessageUrlMethod' => 'POST',
'MessageRouteEnabled' => true,
'MessageAuthenticationType' => 'Basic',
'MessageUsername' => 'admin',
'MessagePasswordToken' => 'passwordORbearerToken',
'CallbackMessageUrl' => 'https://apiendpoint.com',
'CallbackMessageUrlMethod' => 'POST',
'CallbackMessageAuthenticationType' => 'Basic',
'CallbackMessageUsername' => 'admin',
'CallbackMessagePasswordToken' => 'password',
'InboundBypass' => true,
'OutboundBypass' => true,
'IntelligentRouteEnabled' => true,
'AccountId' => 'DID-eab92510-1040-45a5-bb9c-0bad927SDY878W'
]),
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/message/routes"
payload := strings.NewReader("{\n \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\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/message/routes")
.header("Content-Type", "application/json")
.body("{\n \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/message/routes")
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 \"RouteName\": \"Main SMS Webhook\",\n \"MessageUrl\": \"https://apiendpoint.com\",\n \"MessageUrlMethod\": \"POST\",\n \"MessageRouteEnabled\": true,\n \"MessageAuthenticationType\": \"Basic\",\n \"MessageUsername\": \"admin\",\n \"MessagePasswordToken\": \"passwordORbearerToken\",\n \"CallbackMessageUrl\": \"https://apiendpoint.com\",\n \"CallbackMessageUrlMethod\": \"POST\",\n \"CallbackMessageAuthenticationType\": \"Basic\",\n \"CallbackMessageUsername\": \"admin\",\n \"CallbackMessagePasswordToken\": \"password\",\n \"InboundBypass\": true,\n \"OutboundBypass\": true,\n \"IntelligentRouteEnabled\": true,\n \"AccountId\": \"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W\"\n}"
response = http.request(request)
puts response.read_body{
"MessageRouteId": "MRID-ad0ff867-57dc-4aeb-80e9-9d18349080e9",
"AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
"RouteName": "Main SMS Webhook",
"MessageUrl": "https://apiendpoint.com",
"MessageUrlMethod": "POST",
"MessageRouteEnabled": false,
"MessageAuthenticationType": "Basic",
"MessageUsername": "admin",
"MessagePasswordToken": "passwordORbearerToken",
"CallbackMessageUrl": "https://apiendpoint.com",
"CallbackMessageUrlMethod": "POST",
"CallbackMessageAuthenticationType": "Basic",
"CallbackMessageUsername": "admin",
"CallbackMessagePasswordToken": "password"
}{
"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
Friendly name for the message route
Example:
"Main SMS Webhook"
Primary webhook URL for inbound messages
Example:
"https://apiendpoint.com"
HTTP method for webhook delivery
Available options:
GET, POST Example:
"POST"
Enable or disable this message route
Example:
true
Authentication type for primary webhook
Available options:
None, Basic, Bearer Example:
"Basic"
Username for Basic auth (if applicable)
Example:
"admin"
Password for Basic auth or token for Bearer auth
Example:
"passwordORbearerToken"
Fallback/callback webhook URL
Example:
"https://apiendpoint.com"
HTTP method for callback webhook
Available options:
GET, POST Example:
"POST"
Authentication type for callback webhook
Available options:
None, Basic, Bearer Example:
"Basic"
Username for callback Basic auth
Example:
"admin"
Password/token for callback auth
Example:
"password"
Bypass AI Guardian filtering for inbound messages on this route
Example:
true
Bypass AI Guardian filtering for outbound messages on this route
Example:
true
Enable intelligent routing features (AI-assisted message routing)
Example:
true
Account ID to associate with this message route
Example:
"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W"
Response
Success — returns the newly created Message Route ID (MRID)
The response is of type object.
⌘I