> ## 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 items

Adds items to a list. The shape of each item in the `items` array must match the list's
`objectType`. Sending the wrong shape (e.g. a contact item to a company list) returns
`400`. You can add up to **100 items** per request.

## Request

#### Path

<ParamField path="listId" type="string" required>
  Obfuscated listId returned by the overview endpoint.
</ParamField>

#### Body

<ParamField body="items" type="object[]" required>
  Up to 100 items to add. The item shape depends on the list's `objectType`:

  * **COMPANY** — `{ "countryCode": "BE", "companyId": "1778186251" }`
  * **LEGAL\_ENTITY** — `{ "legalEntityId": "998877", "countryCode": "BE" }` (`countryCode` is optional)
  * **CONTACT** — `{ "company": { "countryCode": "BE", "companyId": "1778186251" }, "identifier": { "contactId": "123456" } }`
</ParamField>

<RequestExample>
  ```json Body (COMPANY list) theme={null}
  {
      "items": [
          { "countryCode": "BE", "companyId": "1778186251" }
      ]
  }
  ```
</RequestExample>

## Response

<ResponseField name="success" type="boolean">
  `true` when at least one item was added successfully.
</ResponseField>

<ResponseField name="failed" type="object[]">
  Items that could not be added, each with the original `item` and a `message` explaining
  why (e.g. `Company not found`, `Invalid contactId`).
</ResponseField>

<ResponseExample>
  ```json Response - 200 theme={null}
  {
      "success": true,
      "failed": [],
      "message": "Successfully added 1 item(s) to the list."
  }
  ```
</ResponseExample>