API Reference
GuidesAPI ReferenceLogin

Create Phone Numbers

post
https://api.firstorion.com/exchange/v1/businesses//phone-numbers

Create Phone Numbers

The following are reasons a number might have been rejected:

ReasonDescriptionResponse Code
INVALID_NUMBERInvalid Phone Number201
ALLOCATED_NUMBER_BUSINESSPhone Number exists within under a different business within same reseller201
ALLOCATED_NUMBER_GRANT_CONFLICTPhone Number exists within another reseller (with Service Grant Conflict)201
DUPLICATE_NUMBERPhone Number is duplicated in the request201
RELATIONSHIP_NOT_FOUNDPhone Number is created with an invalid relationship (BU/Program not found)201
INVALID_RELATIONSHIPPhone Number is created with an invalid relationship (assigned to invalid BU-Program-Group-delivery channel Relationship)201
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

System generated unique identifier for the business

Body Params
string
required

The most common purpose why the phone number is making calls. Must be one of GET /exchange/v1/reference-data/call-purposes

boolean
Defaults to false

Is the phone number used to make Verified calls

relationships
object

Association of the phone number with Business, Business Units, Programs, etc.

string
required
7 to 15

Phone number in E.164 format.

Headers
string
required

Access Token

Responses

401

Unauthorized

403

Forbidden

Updated 29 days ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 29 days ago