Bulk Contacts

PUT /v1/lists/{id}/contacts

Bulk Contacts

cURL

curl --request PUT \
  --url https://api.bizzy.ai/v1/lists/{id}/contacts \
  --header 'Authorization: Bearer <token>'

Response - 200

{
  "success": true,
  "message": "Successfully added 99 contacts to the list",
  "failed": [
    {
      "companyIdentifier": {
        "country": "BE",
        "companyNumber": "770493071",
      },
      "contacts": [ // Example error contacts
        {
          "contactIdentifier": {
            "contactId": "123",
          },
          "message": "Contact not found"
        }
      ],
      "message": null
    },
    {
      "companyIdentifier": { // Example error company
        "country": "BE",
        "companyNumber": "123",
      },
      "contacts": null,
      "message": "Company not found"
    }
  ]
}

This only works for static lists!

Request

Body

companyContacts · array

Show companyContact properties

company · object · required

Show company properties

companyNumber · string · required

• Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
• The Netherlands: KVK number.
• France: SIREN number.

countryCode · string · required

countryCode can be either BE, NL or FR

contacts · array · required

Show contact properties

contactId · string · required

contactId is the unique identifier you get from the contacts endpoint.

You can add up to 50 contacts per company to a list at once.

You can add contacts of up to 100 companies to a list at once.

Response - 200

{
  "success": true,
  "message": "Successfully added 99 contacts to the list",
  "failed": [
    {
      "companyIdentifier": {
        "country": "BE",
        "companyNumber": "770493071",
      },
      "contacts": [ // Example error contacts
        {
          "contactIdentifier": {
            "contactId": "123",
          },
          "message": "Contact not found"
        }
      ],
      "message": null
    },
    {
      "companyIdentifier": { // Example error company
        "country": "BE",
        "companyNumber": "123",
      },
      "contacts": null,
      "message": "Company not found"
    }
  ]
}