Developer

Developer - Phone Numbers

Create Phone Number

Changed on Oct 14, 2026

Create a new phone number entry for the current customer.

This endpoint is restricted to developer users only. Creates a phone number or SIP endpoint entry that can be used for inbound call routing.

phone_number: The phone number (e.g., +15551234567) or SIP endpoint (e.g., 1000)
label: Optional friendly label like "Main Line" or "After Hours"
is_active: Whether the number is active (default: true)

post/developer/phone-numbers

Request

Base URL: https://api.openintake.ai (the document declares no server; this is the origin it was published from)
URL: https://api.openintake.ai/developer/phone-numbers
Auth: none declared

Request body

phone_numberstring required

Phone number or SIP endpoint (e.g., +15551234567 or 1000)

labelstring nullable

Friendly label like 'Main Line' or 'After Hours'

is_activeboolean required

Whether the number is active

is_testboolean required

Whether this is a test number (calls won't make real changes)

provider'twilio' | 'daily' | 'vapi' required

Telephony provider (twilio, daily, or vapi)

agent_platform'pipecat' | 'vapi'

Voice agent platform: 'pipecat' or 'vapi'

inbound_squad_idstring nullable

Vapi squad ID for inbound assistant-request routing

outbound_squad_idstring nullable

Vapi squad ID for outbound calls

outbound_squad_id_esstring nullable

Vapi squad ID for outbound calls to Spanish-language leads (falls back to outbound_squad_id)

business_hours_inbound_squad_idstring nullable

Vapi squad ID for inbound calls during business hours (used when business_hours_enabled feature flag is on)

after_hours_inbound_squad_idstring nullable

Vapi squad ID for inbound calls outside business hours (used when business_hours_enabled feature flag is on)

outbound_enabledboolean

Whether this number is available for automated outbound dialing

provider_bypass_enabledboolean

Route inbound Twilio calls through our own /telephony/inbound-vapi endpoint instead of Vapi's inbound webhook. Required for attended transfer, which needs Twilio call control to stay on our side

is_bounce_backboolean

Dedicated bounce-back return line: unanswered transferred calls forwarded back here are matched to their original call and the conversation is injected into the inbound squad

is_staff_transferboolean

Dedicated staff-to-AI transfer line: the PBX AI extension forwards here; the caller is matched to the AI call they were transferred out of, which stays canonical and absorbs this leg

bounce_back_intake_squad_idstring nullable

Vapi squad ID for bounce-backs whose original call was transferred to intake (Intake Dept / On Call); falls back to inbound_squad_id

vapi_phone_number_idstring nullable

VAPI phone number resource ID (for outbound API calls)

default_greeting_overridestring nullable

Per-number default greeting; overrides the customer-wide default/business-hours greeting selection for calls to this number

contact_greeting_overridestring nullable

Per-number known-contact greeting template ({first_name}/{last_name}); overrides the customer-wide contact greeting for calls to this number

Response

Successful Response