Documentation

VoiceRail is the conversation engine. Your backend is the brain. We handle speech, turn-taking, and timing. You bring the reasoning.

New to VoiceRail?

Make your product callable by phone in under 5 minutes.

Quickstart Guide

Quick Example

// 1. Create an assistant (no webhook required!)
curl -X POST https://api.voicerail.ai/v1/assistants \
  -H "Authorization: Bearer $VOICERAIL_KEY" \
  -H "X-Organization-Id: $ORG_ID" \
  -d '{
    "name": "Alex",
    "archetype": "helper",
    "discProfile": { "dominance": 45, "influence": 70, "steadiness": 60, "conscientiousness": 50 },
    "voice": { "provider": "azure", "voiceId": "en-US-JennyNeural" }
  }'

// 2. Make a call - that's it!
curl -X POST https://voice.voicerail.ai/api/v1/calls \
  -H "Authorization: Bearer $VOICERAIL_KEY" \
  -H "X-Organization-Id: $ORG_ID" \
  -d '{ "assistantId": "asst_xxx", "toPhoneNumber": "+15551234567" }'

Need Help?

Can't find what you're looking for? Our team is here to help.