Skip to main content
POST
/
v1
/
agents
/
import-queue
/
{sessionId}
/
companies
Add Companies to Import Queue
curl --request POST \
  --url https://api.bizzy.ai/v1/agents/import-queue/{sessionId}/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companies": [
    {
      "customer": "<string>",
      "country": "<string>",
      "name": "<string>",
      "website": "<string>",
      "vat": "<string>"
    }
  ]
}
'
{
  "companies": [
    {
      "customer": "LEAD",
      "country": "BE",
      "name": "Example Company NV",
      "website": "https://example.com",
      "vat": "BE0123456789"
    },
    {
      "customer": "CUSTOMER",
      "name": "Another Company BV",
      "country": "NL"
    }
  ]
}

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.

Add one or more companies to an existing import queue session. You can call this endpoint multiple times to add companies in batches.

​
Request

​
Path Parameters

​
sessionId
string
required
The session ID returned from the start import queue endpoint

​
Body

​
companies
array
required
Array of company objects to import. Must contain at least 1 and at most 250 companies.

​
Company Matching

To accurately match companies in Bizzy’s database, provide identifying information for each company: Preferred identifier:
  • vat - The VAT number is the most reliable identifier as it’s unique per company and allows for a perfect 1-on-1 match
Alternative identification:
  • If no VAT number is available, provide a combination of:
    • name - Company name
    • country - Country code
    • website - Company website
When using the alternative method, Bizzy performs a combined search using all provided fields and selects the company that best matches the data in our database.
For best results, always include the VAT number when available. When VAT is not available, provide as many identifying fields as possible (name, country, website) to improve matching accuracy.

​
Response

{
  "companies": [
    {
      "customer": "LEAD",
      "country": "BE",
      "name": "Example Company NV",
      "website": "https://example.com",
      "vat": "BE0123456789"
    },
    {
      "customer": "CUSTOMER",
      "name": "Another Company BV",
      "country": "NL"
    }
  ]
}
​
success
boolean
Whether the companies were successfully added to the queue
​
added
number
The number of companies added in this request

​
Notes

  • The session must be in PENDING status to accept companies
  • You can call this endpoint multiple times to add companies in batches
  • Each request can contain a maximum of 250 companies
  • Companies are not processed until you complete the session