Skip to main content
This guide walks you through setting up Vaani from scratch. By the end, you’ll have a working voice agent that can make real outbound calls. The whole process takes about 15–20 minutes.

​
What You’ll Set Up

1

Create Your Account (~2 min)

Sign up at app.vaanivoice.ai and explore your dashboard. → Create an Account
2

Create and Configure an Agent (~5 min)

Set up your voice agent with a prompt, language, voice, and metadata variables. You’ll get an agent_id (UUID) that identifies your agent in every API call. → Create an Agent
3

Set Up Telephony (~5 min)

Connect a phone number so your agent can make and receive real calls. → Set Up Telephony
4

Generate an API Key (~2 min)

Create an API key to authenticate your requests to the Vaani API. → Generate an API Key
5

Make Your First Call (~5 min)

Use your agent_id and API key to trigger an outbound call and hear your agent in action. → Quickstart

​
Important Identifiers

You’ll encounter several identifiers throughout the setup process. Here’s a quick reference so you don’t mix them up:
These identifiers serve different purposes. The most common mistake is confusing agent_id (which identifies your agent) with call_id (which identifies a specific call). When in doubt, check the Concepts page.

​
What You’ll Need

Before you start, make sure you have:
  • A web browser — for accessing the Vaani dashboard
  • A phone number to call for testing — your personal mobile works great
  • A terminal or HTTP client — for making API calls (cURL, Postman, or a Python environment)
  • Basic familiarity with REST APIs — helpful but not required; we’ll walk through every step
Video walkthrough coming soon. Follow the steps above — they cover everything the video will.

​
Next Step

Create Your Account

Sign up at app.vaanivoice.ai and explore your dashboard