Skip to main content

​
Quickstart

This guide will help you make your first API call to Voicy in just a few minutes.

​
Prerequisites

  • A Voicy account (sign up here)
  • An API key (create one)
  • A phone number assigned to your account with an agent configured

​
Step 1: Set Up Your Environment

Store your API key as an environment variable: 
export VOICY_API_KEY="voicy_sk_live_your_key_here"

​
Step 2: List Your Calls

Let’s start by listing recent calls to verify your API key works: 
curl -X POST https://api.voicy.co/v1/list-calls \
  -H "Authorization: Bearer $VOICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 5}'

​
Step 3: Make an Outbound Call

Now let’s initiate an AI-powered phone call: 
curl -X POST https://api.voicy.co/v1/create-phone-call \
  -H "Authorization: Bearer $VOICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number": "+15559876543",
    "dynamic_variables": {
      "customer_name": "John"
    }
  }'
Replace +15551234567 with a phone number assigned to your account, and +15559876543 with the destination number.

​
Step 4: Get Call Details

After the call completes, retrieve the full details including transcript: 
curl https://api.voicy.co/v1/get-call/YOUR_CALL_ID \
  -H "Authorization: Bearer $VOICY_API_KEY"

​
What’s Next?

API Reference

Explore all available endpoints

Error Handling

Learn how to handle API errors