~5 min

Quickstart

Get a number routing to your voice agent in a few minutes.

1. Create an account

Sign up at /signup. You land in the console with a workspace ready to go.

2. Get a number

Two options on Numbers:

  1. Import a SIP number (BYO)— point your carrier's trunk at Voylo and set the allowed source IPs.
  2. Rent a Voylo number — pick a country, choose channels, complete KYC, and pay the first month from your wallet.

3. Connect your voice agent

Voylo bridges calls to your agent over SIP — it never touches your provider's API keys. On Trunks, create an inbound trunkand add your agent's SIP URI as a destination (Vapi, Retell, ElevenLabs, LiveKit, OpenAI Realtime, Pipecat, or any SIP endpoint). Add more destinations for automatic failover.

Or skip the agent
Prefer to run an IVR or custom call flow? Attach an Application instead and drive the call with VoyloML.

4. Point the number at it

Open your number, and in the Destination card pick the inbound trunk (or application) you just created. Inbound calls now route there.

5. Place a test call

Dial the number from any phone, or use Test inbound on the number's page to simulate one. It shows up in Calls with the direction, outcome, destination, and routing attempts.

From the API

Authenticate with an API key (create one) and the X-Workspace-Id header:

cURL
curl https://api.voylo.io/v1/numbers \
-H "Authorization: Bearer $VOYLO_API_KEY" \
-H "X-Workspace-Id: $VOYLO_WORKSPACE_ID"

Or use the Node / Python SDKs for the REST client and a VoyloML builder.

Next

Read Concepts for the full mental model, or VoyloML to build call flows.