---
title: "POST /BillableItems"
method: POST
path: "/BillableItems"
tags: ["BillableItems"]
---

# POST /BillableItems

`POST /BillableItems`

## Request body

- CreateBillableItemDto
  - `code` string, nullable
  - `name` string
  - `invoiceName` string, nullable
  - `description` string, nullable
  - `basePrice` union
    - number, double
    - string, double
  - `dispenseFee` union
    - number, double
    - string, double
  - `isTaxable` boolean
  - `vatCategory` string, nullable
  - `notes` string, nullable
  - `components` CreateBillableItemComponentDto[]
    - `inventoryItemId` string, nullable
    - `componentType` string, nullable — Optional; defaults to "Inventory" (the only supported type in v1).
    - `quantityMultiplier` union
      - number, double
      - string, double
    - `isDefault` boolean, nullable
    - `notes` string, nullable

## Response `200`

OK

- BillableItemDto
  - `id` string
  - `code` string, nullable
  - `name` string
  - `invoiceName` string, nullable
  - `description` string, nullable
  - `basePrice` union
    - number, double
    - string, double
  - `dispenseFee` union
    - number, double
    - string, double
  - `isTaxable` boolean
  - `vatCategory` string, nullable
  - `isActive` boolean
  - `notes` string, nullable
  - `componentCount` union
    - integer
    - string, int32
  - `components` BillableItemComponentDto[]
    - `id` string
    - `billableItemId` string
    - `componentType` string — One of: "Inventory", "Retail", "ServiceCatalog". Always "Inventory" in v1.
    - `inventoryItemId` string, nullable
    - `quantityMultiplier` union
      - number, double
      - string, double
    - `isDefault` boolean
    - `isActive` boolean
    - `notes` string, nullable
    - `itemName` string — Flattened name from the referenced inventory item.
    - `itemCode` string — Flattened code/SKU from the referenced inventory item.
    - `category` string, nullable — Referenced inventory item's category (e.g. "Vaccine"). Lets the dispense modal require route/site for vaccine components.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/a905bde4e796/schema)