> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knotie-ai.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a VAPI agent

> Onboard or import a VAPI agent for a customer.

## What “import” means

Importing pulls your existing VAPI agents into Knotie AI Pro so you can manage them in the Partner Portal.

This is the fastest option if you already built agents in VAPI and want them available inside Knotie AI Pro.

## Before you start

* You need a **VAPI API key**.
* You must be able to log in to the Partner Portal.

## Import VAPI agents into Knotie AI Pro

1. In the Partner Portal, open **AI Agents**.
2. Click **VAPI Agents**.
3. Click **Import Agents**.
4. In the modal, paste your **VAPI API Key**.
5. Click **Fetch VAPI Agents**.
6. Select the agents you want to import:
   * Agents already imported show as **Imported**.
   * Use **Select All** if you’re importing multiple at once.
7. Click **Import**.

Knotie AI will import the agents and automatically handle the “plumbing” behind the scenes (analytics registration + webhook configuration).

## After import (recommended next step)

* Open an imported agent and map it to a customer if needed.

<Tip>
  Once an agent is assigned to a customer, Knotie AI Pro automatically wires in a live MCP server — the agent can use tools from any app the customer has connected without a rebuild. See [Connected App Tools](/agents/connected-app-tools).
</Tip>

## Troubleshooting

* **“Please update your VAPI API key in settings”**
  * Go to **Settings** and update your VAPI API key.
  * Return to **VAPI Agents** and try importing again.
* **You hit a plan limit**
  * VAPI agents are a premium feature. If your plan doesn’t include it, you’ll see an upgrade message.
* **No agents available for import**
  * This usually means all your VAPI agents are already imported.

## Screenshots

<img src="https://mintcdn.com/kno2getherlabsltd/OcV0TG48maU0R4kd/images/Screenshot2025-12-28at02.15.59.png?fit=max&auto=format&n=OcV0TG48maU0R4kd&q=85&s=42d7d05b9a218f2209d4d64d9dad3575" alt="VAPI Agents page with Refresh, Import, and Create Agent buttons in the header and an imported agent card" width="1440" height="900" data-path="images/Screenshot2025-12-28at02.15.59.png" />

<img src="https://mintcdn.com/kno2getherlabsltd/OcV0TG48maU0R4kd/images/Screenshot2025-12-28at02.16.06.png?fit=max&auto=format&n=OcV0TG48maU0R4kd&q=85&s=1a0d6e7459549e728c81c6cc7cb2dd54" alt="Import VAPI Agents modal with VAPI API Key field and Fetch VAPI Agents button" width="1440" height="900" data-path="images/Screenshot2025-12-28at02.16.06.png" />

<img src="https://mintcdn.com/kno2getherlabsltd/OcV0TG48maU0R4kd/images/Screenshot2025-12-28at02.16.23.png?fit=max&auto=format&n=OcV0TG48maU0R4kd&q=85&s=1da598e9a3d788d3b735b16d9cb28c2b" alt="Create VAPI Agent modal showing Basic Settings step with Agent Name, First Message, System Prompt, and Voice Provider fields" width="1440" height="900" data-path="images/Screenshot2025-12-28at02.16.23.png" />
