Sign in
Phone Numbers

Import Phone Number

post/agents/phone-numbers

Headers

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

API version header.

Request body

labelstring required

A human-readable name for the phone number.

numberstring required

The phone number in E.164 format.

agent_idstring

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

Response

Phone number imported.

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.