---
title: "Create a stock item"
method: POST
path: "/accounting/stockItems"
tags: ["Stock Items"]
---

# Create a stock item

`POST /accounting/stockItems`

## Request

- Base URL: `https://api.clearbooks.co.uk/v1`
- URL: `https://api.clearbooks.co.uk/v1/accounting/stockItems`
- Auth: OAuth 2 (authorization code, authorization URL `https://secure.clearbooks.co.uk/account/action/oauth/`, token URL `https://api.clearbooks.co.uk/oauth/token`, scopes: `accounting.stock_items:write`)

## Headers

- `X-Business-ID` integer

## Request body

- StockItemCreate
  - `id` integer
  - `name` string
  - `sku` string
  - `type` 'purchases' | 'sales' | 'both'
  - `description` string
  - `salesUnitPrice` number, double
  - `salesAccountCode` integer
  - `salesVatRateKey` string
  - `salesQuantity` number, double
  - `purchaseUnitPrice` number, double
  - `purchaseAccountCode` integer
  - `purchaseVatRateKey` string
  - `purchaseQuantity` number, double
  - `trackStock` boolean

## Response `201`

Stock item created

- StockItemBase
  - `id` integer
  - `name` string
  - `sku` string
  - `type` 'purchases' | 'sales' | 'both'
  - `description` string
  - `salesUnitPrice` number, double
  - `salesAccountCode` integer
  - `salesVatRateKey` string
  - `salesQuantity` number, double
  - `purchaseUnitPrice` number, double
  - `purchaseAccountCode` integer
  - `purchaseVatRateKey` string
  - `purchaseQuantity` number, double
  - `trackStock` boolean

## Other responses

- `400`: The request was malformed or missing required parameters
- `401`: A valid authorisation token is required to perform this action
- `403`: No permission was granted to perform this action
- `422`: The request was well formed, but could not be actioned due to business rule constraints
- `429`: The application is making too many requests and has been rate limited

---

[API](https://skmtc.dev/clearbooks/apis/clear-books-api.md) · [All operations](https://skmtc.dev/clearbooks/apis/clear-books-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clearbooks/apis/clear-books-api/revisions/5e46fa6863a7?raw)