Phone Numbers

Provision Cartesia Number

Provision a new Cartesia-managed US phone number

post/agents/phone-numbers/provision

Headers

Cartesia-Version'2026-03-01' date required

Example:2026-03-01

API version header.

labelstring required

A human-readable name for the phone number.

agent_idstring

Optionally assign an agent to answer inbound calls to this number. Omit to keep the number outbound-only.

Phone number provisioned.

idstring required

Unique identifier for the phone number.

labelstring nullable

A human-readable name for the phone number.

numberstring required

The phone number in E.164 format (e.g. +14155551234).

created_atstring date-time required

UTC timestamp when the phone number was created.

updated_atstring date-time required

UTC timestamp when the phone number was last updated.