Skip to main content
POST
Provision

Authorizations

Authorization
string
header
required

AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...

Body

application/json
agent_id
string
required

ID of the AI agent to assign this phone number to (e.g. 'agt_abc123')

country
string
default:US

Country code for the phone number (currently only 'US' is supported)

number_type
string
default:local

Type of phone number: 'local' or 'tollfree'

area_code
string | null

Preferred 3-digit US area code (e.g. '212' for NYC, '415' for SF, '310' for LA)

pattern
string | null

Legacy digit pattern match (prefer area_code instead)

Response

Successful Response