Create an inbound trunk matched by the caller number

POST 
/v1/trunks/by-caller-number

Inbound calls from number land on this trunk; the number becomes the trunk name, so name is rejected. host and permit are required. Without secret a strong random one is generated and returned once. port defaults to 5060. type is not accepted: it is netgsm for Netgsm hosts and custom otherwise. Creating a trunk is capped by the number of phone line packages the organization owns; every existing trunk except fct ones counts against it (fctmvno counts). No phone line package returns 403 (also when the package check cannot be completed); a full quota returns 422, and a second create running for the same organization returns 429 after waiting up to 5 seconds. A 429 is also returned when the PBX trunk limit for the organization is reached. Requires api_user|trunk_create.

Request

Responses

201

Created

401

Unauthenticated

403

Missing permission, or no phone line package owned

409

A trunk with this number is already registered

422

Validation error or phone line quota exceeded

429

Rate limit exceeded, another create in progress, or the PBX trunk limit for the organization reached

503

The PBX is unreachable, or no PBX tenant is assigned to the organization