Provision
Buy a US phone number for your AI agent.
Searches for and purchases a real US phone number from the telephony provider, then attaches it to the specified AI agent. Once attached, the agent can make outbound calls and receive inbound calls on this number.
Each AI agent can only have ONE active phone number. Costs $2.00 per number.
Request body:
- agent_id: str (required) — the AI agent to assign this number to
- country: str (must be “US”)
- number_type: “local” | “tollfree”
- area_code: preferred 3-digit US area code (e.g. “212” for NYC, “415” for SF)
Authorizations
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
ID of the AI agent to assign this phone number to (e.g. 'agt_abc123')
Country code for the phone number (currently only 'US' is supported)
Type of phone number: 'local' or 'tollfree'
Preferred 3-digit US area code (e.g. '212' for NYC, '415' for SF, '310' for LA)
Legacy digit pattern match (prefer area_code instead)
Response
Successful Response