Creates a new inbound route which can then be assigned as either a primary or a failover voice route for a phone number on your account. Please see List Inbound Routes to review the route values that you can associate with your Flowroute phone numbers.
Data object composed of the following:
This will always be route.
Object composed of the following route attributes:
Unique friendly name for the inbound route to be created.
Indicates the type of route: host, number, uri
Value of the route, dependent on the route_type:
If the route_type is host, the value must be an IP address or URL
with an optional port number. For example, an IP address could be 22.214.171.124:5060 or a URL could be myphone.com. If no port is specified, the server will attempt to use DNS SRV records.
If the route_type is number, the value must be an 11-digit number in E.164 format. e.g.,16476998778.
If the route_type is uri, the value must be formatted as protocol:user@domain[:port][;transport=<tcp/udp/tls>.
For example, sip:email@example.com, sip:firstname.lastname@example.org:5060;transport=tcp, or sips:email@example.com.
Additionally, you can specify that your SIP traffic be TLS encrypted. To enable this feature, in th HOST or URI specified, indicate the transport protocol desired - tcp, upd or tls ;transport=tls.
Advanced Feature - Weight Based Routing Using Parameters
Flowroute's traditional routing parameters; primary and failover, allow customers to specify a route that takes 100% of traffic unless an issue is detected with the primary route and then 100% of traffic is directed to the failover route. The Weight Based Routing feature allows customers to utilize primary and failover route specification as a percentage of traffic spread across both routes.
By adding a ;weight=X parameter to both routes, traffic can be conditionally spread across the two.
Weights must be applied to both primary and failover routes for the DID in question.
Weight values are specified between 0 and 1000 with 1000 being the heaviest weight and calculated as an overall percentage.
- 100/(400+100) = 20%
400/(400+100) = 80%
The PoP to receive traffic from. See the section on PoPs for more information.
If not specified, the Preferred PoP for the account will be used. If there is no Preferred PoP set, then the Edge Strategy defaults to US-West-OR. This may result in 403 FORBIDDEN results if a Route with the same parameters for alias, value, and edge_strategy_id already exists.
On success, the HTTP status code in the response header is 200 OK and the response body contains a route object in JSON format. On error, the header status code is an error code and the response body contains an array of error objects.
Route object composed of the following:
Object composed of attributes described above.
ID of the newly created route object.
Links object pointing to the route's URI. For example, https://api.flowroute.com/v2/routes/98396.
This will always be route.
Links object pointing to your newly created route. For example, https://api.flowroute.com/v2/routes/98396.