Create free phone numbers using Cartesia. The number of free phone numbers depends on your subscription plan:
| Plan | Phone number slots |
|---|
| Free | 1 |
| Pro | 3 |
| Startup | 5 |
| Scale | 10 |
| Enterprise | Custom |
- US numbers only — all Cartesia-managed numbers are from the US
- Outbound to US only — outbound calls are limited to US destination numbers, regardless of agent deployment region
Provisioning a Number
- Go to Phone Numbers in the sidebar
- Click Add Number → Cartesia Number
- Enter a name for the number
- Optionally assign an agent
cartesia phone-numbers provision "My Agent Number"
cartesia phone-numbers provision "My Agent Number" --agent-id <agent-id>
curl -X POST "https://api.cartesia.ai/agents/phone-numbers/provision" \
-H "Authorization: Bearer $CARTESIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Cartesia-Version: 2026-03-01" \
-d '{
"label": "My Agent Number"
}'
If you’ve reached your phone number limit, delete an existing Cartesia number or upgrade your plan to add more.
Deleting a Number
Deletion is permanent — the number is released and cannot be recovered.
- Go to Phone Numbers and click on the number
- Unassign the number from any agent
- Click Delete
cartesia phone-numbers delete <phone-number-id>
Unassign the number first, then delete it:curl -X DELETE "https://api.cartesia.ai/agents/phone-numbers/YOUR_PHONE_NUMBER_ID" \
-H "Authorization: Bearer $CARTESIA_API_KEY" \
-H "Cartesia-Version: 2026-03-01"
