---
title: "Create Worksheet Item"
method: POST
path: "/financials/{financialsId}/worksheet/items"
tags: ["financials"]
---

# Create Worksheet Item

`POST /financials/{financialsId}/worksheet/items`

Creates a new item in a worksheet using its financial ID. If the worksheet does not exist, it will be created, and the sectionId parameter should be left empty. If the worksheet already exists, you must provide the sectionId parameter, which should be a valid section ID within the worksheet.

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Path parameters

- `financialsId` string, uuid, required

## Request body

- WorksheetItemPost
  - `sectionId` string, uuid, nullable — The unique ID of the worksheet section where the item will be created. If the worksheet does not exist, this field should be left empty.
  - `parentItemId` string, uuid, nullable — The unique ID for the parent item of this item.
  - `itemName` string, nullable — The name of the item.
  - `description` string, nullable — The description of the item.
  - `quantity` integer, nullable — The quantity for this item.
  - `unitOfMeasure` string, uuid, nullable — The unique ID for the unit of measure.
  - `costPerUnit` number, nullable — The cost/unit for this item.
  - `cost` number, nullable — The cost for this item.
  - `price` number, required — The price for this item.

## Response `201`

Created

- IdPost
  - `id` string, uuid — The unique identifier of the resource to post.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values
- `429` — Too Many Requests

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/revisions/3a9e3886e400/schema)