---
title: "Create an invoice item"
method: POST
path: "/invoice-items"
tags: ["Invoice Items"]
---

# Create an invoice item

`POST /invoice-items`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/invoice-items`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required: The name of the invoice item. Max 255 characters.
  - `isActive` boolean: Whether the invoice item is active.
  - `typeId` 'income' | 'expense': The type of the invoice item.

## Response `200`

200

- InvoiceItem
  - `id` string: The unique identifier for the object.
  - `name` string: The name of the invoice item.
  - `isActive` boolean: Whether the invoice item is active.
  - `typeId` 'income' | 'expense': The type of the invoice item.
  - `readOnly` boolean: Whether the invoice item is read-only. System-created invoice items cannot be modified or deleted.
  - `createdAt` string, date-time: The timestamp when the object was created.

## Other responses

- `400`: 400
- `409`: 409

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)