​
Prerequisites

Before you begin, make sure you have:
  • A Feather account (sign up here)
  • Your API key from the dashboard
  • A phone number to test with

​
Step 1: Create Your First Agent

Let’s create a simple documentation agent: 
curl -X POST "https://prod.featherhq.com/api/v1/agents" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Docs Agent",
    "description": "Agent for getting docs",
    "channels": [
      "INBOUND_CALL"
    ],
    "voicemailMessage": null,
    "sttConfigId": "nova-3-stt",
    "ttsConfigId": "aura-2-tts",
    "llmConfigId": "gpt-4o-mini-llm",
    "overrideSTTConfig": null,
    "overrideTTSConfig": null,
    "overrideLLMConfig": null,
    "mode": "PROMPT",
    "prompt": {
      "system": "You are a helpful assistant that can answer questions about the documentation.",
    },
    "useKnowledgeBase": false,
    "voiceId": "6011b4c8-6140-4b7e-8a92-d9880de97b77"
  }'

​
Step 2: Connect Twilio Account

Connect your Twilio account to enable phone number functionality: 
curl -X POST "https://prod.featherhq.com/api/v1/twilio/import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSid": "YOUR_TWILIO_ACCOUNT_SID",
    "authToken": "YOUR_TWILIO_AUTH_TOKEN",
    "phoneNumber": "+1234567890"
  }'

​
Step 3: Associate Phone Number with Agent

Associate your phone number with the agent for outbound calls: 
curl -X PUT "https://prod.featherhq.com/api/v1/phone-number/outbound/{id}/dispatch-rule" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentIds": ["YOUR_AGENT_ID"]
  }'

​
Step 4: Make Your First Call

Now let’s test your agent with a call: 
curl -X POST "https://prod.featherhq.com/api/v1/agent/{agentId}/dispatch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "lead-123",
    "firstName": "John",
    "toPhoneNumber": "+1234567890",
    "mode": "audio"
  }'

​
What’s Next?

Congratulations! You’ve created your first voice AI agent. Here are some next steps:

Add Tools

Give your agent capabilities like booking appointments or looking up information.

Knowledge Base

Upload documents so your agent can answer specific questions about your business.

Phone Numbers

Set up inbound numbers for customers to call your agents.

Advanced Guides

Learn advanced techniques for building sophisticated voice agents.

​
Troubleshooting

Running into issues? Check out our troubleshooting guide or reach out to support@featherhq.com.