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

# Start Import Queue

Create a new import queue session for a specific agent. This starts a batch import process that you can add companies to.

## Request

#### Body

<ParamField body="agentId" type="number" required>
  The ID of the agent to import companies into (from the agent overview endpoint)
</ParamField>

## Response

<ResponseExample>
  ```json Response - 200 theme={null}
  {
    "sessionId": 3456789,
    "agentId": 1234567
  }
  ```

  ```json Response - 400 (No API Input Channel) theme={null}
  {
    "error": "Agent does not have an API input channel configured. Please configure an API input channel in platform before importing companies."
  }
  ```

  ```json Response - 400 (Already Processing) theme={null}
  {
    "error": "Agent import queue already processing."
  }
  ```
</ResponseExample>

<ResponseField name="sessionId" type="number">
  The unique identifier for the created import session. Use this ID to add companies and complete the session.
</ResponseField>

<ResponseField name="agentId" type="number">
  The ID of the agent this session belongs to
</ResponseField>

## Prerequisites

Before starting an import queue, ensure:

1. The agent has an **API input channel** configured in the Bizzy platform
2. No other import queue is currently processing for this agent

## Next Steps

After creating a session:

1. Use the returned `sessionId` to [add companies](/api-reference/agent/add-companies) to the queue
2. When all companies are added, [complete the session](/api-reference/agent/complete-import-queue) to trigger processing

<Note>
  **Important**: Completing a new import session will replace all companies from previous API imports. If you need to retain existing companies, include them in your new import session. See [Complete Import Queue](/api-reference/agent/complete-import-queue) for details.
</Note>
