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
Documentation Index
Fetch the complete documentation index at: https://docs.telegent.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Enter the token obtained from the Authentication endpoint
Body
Friendly name for the message route
"Main SMS Webhook"
Primary webhook URL for inbound messages
"https://apiendpoint.com"
HTTP method for webhook delivery
GET, POST "POST"
Enable or disable this message route
true
Authentication type for primary webhook
None, Basic, Bearer "Basic"
Username for Basic auth (if applicable)
"admin"
Password for Basic auth or token for Bearer auth
"passwordORbearerToken"
Fallback/callback webhook URL
"https://apiendpoint.com"
HTTP method for callback webhook
GET, POST "POST"
Authentication type for callback webhook
None, Basic, Bearer "Basic"
Username for callback Basic auth
"admin"
Password/token for callback auth
"password"
Bypass AI Guardian filtering for inbound messages on this route
true
Bypass AI Guardian filtering for outbound messages on this route
true
Enable intelligent routing features (AI-assisted message routing)
true
Account ID to associate with this message route
"DID-eab92510-1040-45a5-bb9c-0bad927SDY878W"
Response
Success — returns the newly created Message Route ID (MRID)
The response is of type object.