Docs

Make your first call in 5 minutes.

The full reference is being polished. Here's the quickest possible quickstart.

01.

Sign up + grab an API key

Create an account, add a card (you won't be charged), and copy the sk_live_… key from your dashboard. We grant $5 in credits at this step.

02.

Buy a number

curl -X POST https://api.pstn.dev/v1/phone-numbers/buy \
  -H 'Authorization: Bearer sk_live_...' \
  -d '{ "country": "US", "area_code": "415" }'

03.

Create an AI agent

curl -X POST https://api.pstn.dev/v1/agents \
  -H 'Authorization: Bearer sk_live_...' \
  -d '{
    "name": "Lead qualifier",
    "system_prompt": "You are a polite outbound sales rep...",
    "first_message": "Hi, this is a quick call from Acme.",
    "voice_id": "cartesia:sonic-turbo:female-en-us"
  }'

04.

Place an outbound call

curl -X POST https://api.pstn.dev/v1/calls \
  -H 'Authorization: Bearer sk_live_...' \
  -d '{
    "to":   "+15558675309",
    "from": "+14155551234",
    "agent": "agent_01HX4P5Q9KZ2"
  }'

Full docs are coming. REST reference, webhook event catalog, SDK guides for Node/Python/Go, Postman collection, and the Pipecat runtime guide. Want early access? [email protected].