Add Companies to Import Queue

POST /v1/agents/import-queue/{sessionId}/companies

Add Companies to Import Queue

cURL

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>"
    }
  ]
}
'

Request

{
  "companies": [
    {
      "customer": "LEAD",
      "country": "BE",
      "name": "Example Company NV",
      "website": "https://example.com",
      "vat": "BE0123456789"
    },
    {
      "customer": "CUSTOMER",
      "name": "Another Company BV",
      "country": "NL"
    }
  ]
}

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.

Show Company properties

customer · string · required

The customer type for this company. Must be one of:

• CUSTOMER - Existing customer
• LEAD - Potential lead
• UNKNOWN - Status unknown

country · string

ISO 3166-1 alpha-2 country code (e.g., BE, NL, FR)

name · string

The name of the company

website · string

The company’s website URL

vat · string

The company’s VAT number

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

Request

{
  "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