Connect a number you already have

POST

https://api.levrage.ai/v1/numbers/connect

Bring a number the account already owns at its carrier. sip works with any carrier or PBX that offers a SIP trunk; exotel sets it up through the connected Exotel account. The reply says what to change at the carrier, if anything. Connected numbers carry no Levrage rent.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

numberstringRequired

The number, in international format, e.g. +918045671234

providerstringOptionalDefaults to sip

sip (any carrier or PBX over SIP) or exotel

sip_addressstring or nullOptional

sip: your carrier’s SIP address (host or IP, optional port)

usernamestring or nullOptional

sip: the SIP login, if your carrier uses one

passwordstring or nullOptional

sip: its password; never returned

transportstring or nullOptionalDefaults to auto

sip: auto, udp, tcp or tls

exotel_account_idstring or nullOptionalformat: "uuid"

exotel: from GET /v1/numbers/exotel-accounts

agent_idstring or nullOptionalformat: "uuid"

The agent that answers it (optional; set later with PUT /v1/numbers/{number}/agent)

Response

Successful Response

Errors

422

Unprocessable Entity Error