---
title: "Create credit note line item"
method: POST
path: "/credit-notes/{credit_note_id}/line-items/"
tags: ["Credit Note Line Items"]
---

# Create credit note line item

`POST /credit-notes/{credit_note_id}/line-items/`

## Request

- Base URL: `https://api.wafeq.com/v1`
- URL: `https://api.wafeq.com/v1/credit-notes/{credit_note_id}/line-items/`
- Auth: API key in header `Authorization`

Endpoint for creating a new credit note line item.

## Path parameters

- `credit_note_id` string, required

## Query parameters

- `expand` string

## Headers

- `X-Wafeq-Idempotency-Key` string

## Request body

- ApiV1CreditNoteLineItem: A line item of a credit note.
  - `account` string, required: The account associated with this line item.
  - `cost_center` string: The cost center associated with this line item.
  - `created_ts` string, date-time, required: The timestamp in UTC when the line item was created.
  - `custom_fields` object: A mapping of custom field IDs to their values.
  - `description` string, required: The line item description.
  - `discount` number, double, nullable: The discount as the percentage.
  - `id` string, required: The unique identifier of the line item.
  - `item` string: The item associated with this line item.
  - `item_unit_of_measure` string, nullable: The item unit of measure for this line item.
  - `legacy_id` string, required: [Deprecated] The legacy identifier of the line item.
  - `line_amount` number, double, required: The total amount for this line item.
  - `modified_ts` string, date-time, required: The timestamp in UTC when the line item was last modified.
  - `order` integer: The position of the line item within the document.
  - `quantity` number, double, required: The quantity of the item.
  - `tax_amount` number, double, required: The tax amount for this line item.
  - `tax_rate` string: The tax rate applied to this line item.
  - `unit_amount` number, double, required: The unit amount of the item.

## Response `201`

- ApiV1CreditNoteLineItem: A line item of a credit note.
  - `account` string, required: The account associated with this line item.
  - `cost_center` string: The cost center associated with this line item.
  - `created_ts` string, date-time, required: The timestamp in UTC when the line item was created.
  - `custom_fields` object: A mapping of custom field IDs to their values.
  - `description` string, required: The line item description.
  - `discount` number, double, nullable: The discount as the percentage.
  - `id` string, required: The unique identifier of the line item.
  - `item` string: The item associated with this line item.
  - `item_unit_of_measure` string, nullable: The item unit of measure for this line item.
  - `legacy_id` string, required: [Deprecated] The legacy identifier of the line item.
  - `line_amount` number, double, required: The total amount for this line item.
  - `modified_ts` string, date-time, required: The timestamp in UTC when the line item was last modified.
  - `order` integer: The position of the line item within the document.
  - `quantity` number, double, required: The quantity of the item.
  - `tax_amount` number, double, required: The tax amount for this line item.
  - `tax_rate` string: The tax rate applied to this line item.
  - `unit_amount` number, double, required: The unit amount of the item.

## Changes

- **2026-11-03** `b8f5e10134b4`: 1 info
  - added the new optional `query` request parameter `expand`

[Operation history](https://skmtc.dev/wafeq/apis/wafeq-public-api/changes/credit-notes/:credit_note_id/line-items/post.md)

---

[API](https://skmtc.dev/wafeq/apis/wafeq-public-api.md) - [All operations](https://skmtc.dev/wafeq/apis/wafeq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wafeq/apis/wafeq-public-api/revisions/b8f5e10134b4?raw)