Connect or import an agent

vozo can work with an existing voice-agent provider or with agent configurations created in the vozo platform. Start by connecting the provider in organization settings or preparing a supported provider export.

Supported provider imports

The API and MCP currently support configuration listing and import for ElevenLabs, Vapi, and Retell when the provider connection is available. Import coverage is specific to each provider’s configuration shape; unsupported fields can produce warnings or prevent import.

An import creates a vozo agent record from the supported configuration. It does not publish or update the provider’s agent, and it does not copy historical calls, recordings, usage, or billing data.

Connect a provider

Organization members with agent creation access can connect a provider from the vozo console. The HTTP API can connect with a provider API key:

PUT /api/agent-import/connections/{provider}
Content-Type: application/json
Cookie: <authenticated vozo session>

{
  "apiKey": "<provider-api-key>"
}

Supported provider path values are elevenlabs, vapi, and retell. Store provider credentials in vozo’s connection flow; do not include them in agent exports or MCP prompts.

Preview and import

Use GET /api/agent-import/connections/{provider}/agents or MCP’s list_external_voice_agents to find a remote agent. The API also supports submitting an export to POST /api/agent-import/preview before saving it. MCP’s import_external_voice_agent fetches the selected configuration from a saved provider connection and creates the vozo record directly.

After import, connect call events and usage data separately to enable cost, latency, and reliability analysis. vozo’s visible results depend on the evidence available for that agent.

Self-hosted agents

For self-hosted stacks, use the HTTP API to create or import a supported configuration, then ingest call and provider usage through the supported integration path. An MCP client can inspect the resulting vozo workspace, but MCP is not an agent-file upload endpoint or a general event-ingestion API.