Create a phone number

post

Create a new secondary phone number for a customer.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

customerIdstringRequired

Body

application/json

phoneNumberstring · min: 1Required

phoneTypestring · min: 1Required

lineTypestring · enumOptionalPossible values:

lineStatusstring · enumOptionalPossible values:

notestringOptional

Responses

201

Phone number created successfully

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post

/v1/agents/{agentId}/customers/{customerId}/phone-numbers

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/customers/{customerId}/phone-numbers HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "phoneNumber": "text",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "note": "text"
}

{
  "id": "text",
  "phoneNumber": "text",
  "type": "primary",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "verified": true,
  "note": "text",
  "conversationSid": "text",
  "createdAt": "2025-12-11T11:49:21.676Z",
  "updatedAt": "2025-12-11T11:49:21.676Z"
}