---
title: "Create multiple items"
method: POST
path: "/v3/classifications/items/bulk"
tags: ["classifications"]
---

# Create multiple items

`POST /v3/classifications/items/bulk`

Create multiple items with one API request. You can create up to 50 items with one `POST /v3/classifications/items/bulk` request.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- CreateClassificationItemRequestDto[]
  - `type` 'UNKNOWN' | 'SERVICE' | 'INVENTORY' | 'NON_INVENTORY' | 'PAYMENT' | 'DISCOUNT' | 'SALES_TAX' | 'SUBTOTAL' | 'OTHER_CHARGE' | 'INVENTORY_ASSEMBLY' | 'GROUP' | 'SALES_TAX_GROUP' | 'FIXED_ASSET' | 'CATEGORY' | 'EXPENSE', required — Item type
  - `shortName` string — Item short name
  - `name` string, required — Item name
  - `description` string — Item description
  - `parentId` string — BILL-generated ID of the parent item. You can set this field if this item is a child object.
  - `price` number — Item price
  - `expenseChartOfAccountId` string — BILL-generated ID of the chart of accounts for the item when it is used for bills or purchases in your accounting system. The value begins with `0ca`.
  - `purchaseDescription` string — Item description when it is used for bills or purchases in your accounting system
  - `purchaseCost` number — Item purchase cost set in your accounting system
  - `chartOfAccountId` string — BILL-generated ID of the chart of accounts for the item. The value begins with `0ca`.
  - `taxable` boolean — Set as `true` if the item is taxable
  - `percentage` number — Item tax percentage. You can set this field for a set of item `type` values. * `DISCOUNT` * `SALES_TAX` * `OTHER_CHARGE`

## Response `201`

Create multiple items response

- ClassificationItemBulkResponseDto — Response Dto for bulk classification item.
  - `items` ClassificationItemResponseDto[] — List of items
    - `id` string — BILL-generated ID of the item. The value begins with `0ii`.
    - `type` 'UNDEFINED' | 'UNKNOWN' | 'SERVICE' | 'INVENTORY' | 'NON_INVENTORY' | 'PAYMENT' | 'DISCOUNT' | 'SALES_TAX' | 'SUBTOTAL' | 'OTHER_CHARGE' | 'INVENTORY_ASSEMBLY' | 'GROUP' | 'SALES_TAX_GROUP' | 'FIXED_ASSET' | 'CATEGORY' | 'EXPENSE' — Item type
    - `shortName` string — Item short name
    - `name` string — Item name
    - `description` string — Item description
    - `archived` boolean — Set as `true` if the item is archived
    - `parentId` string — BILL-generated ID of the parent item. You can set this field if this item is a child object.
    - `price` number — Item price
    - `expenseChartOfAccountId` string — BILL-generated ID of the chart of accounts for the item when it is used for bills or purchases in your accounting system. The value begins with `0ca`.
    - `purchaseDescription` string — Item description when it is used for bills or purchases in your accounting system
    - `purchaseCost` number — Item purchase cost set in your accounting system
    - `chartOfAccountId` string — BILL-generated ID of the chart of accounts for the item. The value begins with `0ca`.
    - `taxable` boolean — Set as `true` if the item is taxable
    - `percentage` number — Item tax percentage
    - `createdTime` string, date-time — Created date and time
    - `updatedTime` string, date-time — Updated date and time

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/versions/0483350c434e/schema)