Introduction

Welcome to the Revox API

The Revox API provides a comprehensive interface for managing AI voice campaigns, calls, and communications. This API reference documentation is automatically generated from our OpenAPI specification.

API Base URL: https://www.getrevox.com/api

Authentication

All API endpoints are authenticated using Bearer tokens. Include your API key in the Authorization header using the Bearer token format.

Getting Your API Key

1. Log in to the Revox Dashboard
2. Navigate to API Keys section
3. Generate a new API key or use an existing one

Keep your API key secure. Never commit it to version control or expose it in client-side code.

Using Bearer Token Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Example using cURL:

curl -X GET https://www.getrevox.com/api/call/{call_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

Getting Started

1. Obtain your API key from the dashboard
2. Include it in the Authorization header as a Bearer token
3. Make requests to the endpoints documented below

Core API Resources

• Campaigns — Create and manage outbound call campaigns. Upload contact lists, assign an assistant, and launch bulk AI calls with real-time progress tracking and analytics.
• Calls — Place outbound AI calls, schedule them for later, and retrieve call results including transcripts and recordings.
• Assistants — Create and manage AI assistants that define how the agent behaves during calls — prompt, voice and first sentence.
• Voices — Browse available voices from Cartesia and ElevenLabs. Preview voices before assigning them to assistants.