Add outbound phone numbers and/or set an inbound phone number.
Inbound phone number is only supported when this capability is enabled for the client. When setting up for the first time (no existing phone masking configuration), the inbound phone number is required. For subsequent requests, the inbound phone number is optional.
Outbound phone numbers are allowed to call consumer phone numbers to reach customers, whereas the inbound phone number receives calls from consumers.
Note: This endpoint is only required for legacy masked phone number leads before 16th April 2026
Recent Requests
Log in to see full request history
Time
Status
User Agent
Retrieving recent requests…
Loading…
Responses
401
The API key has either expired or doesn't have the required scopes to query this endpoint.
code
description
UNAUTHORIZED_API_KEY
The API key provided is not currently able to query this endpoint.
TOKEN_INVALID
Invalid API key or authorization header.
403
Authorization Error
404
Resource Not Found
429
You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.
500
Internal Server Error
Updated 13 days ago
Language
ShellNodeRubyPHPPython
Credentials
OAuth2
OAuth2
Loading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
201 - PhoneNumbers400 - Missing Inbound Or Outbound400 - Invalid Inbound400 - Inbound Already Exists400 - Missing Inbound For New Setup400 - Invalid Format400 - Duplicate Phone Number400 - Max Limit Reached401 - Unauthorized401 - Invalid Token403 - Authorization Error404 - Resource Not Found429 - Rate limited500 - Internal Server Error