---
title: "Create a new Credit Note Line Item"
method: POST
path: "/credit-notes/{creditnote}/line-items"
tags: ["Credit Note Line Items"]
---

# Create a new Credit Note Line Item

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

Create a new Credit Note Line Item

## Path parameters

- `creditnote` string, required

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Request body

- Stable20240101CreateCreditNoteLineItemRequestModel
  - `creditNoteId` string, required — Credit Note Line Item ID
  - `groupId` string — Credit Note Line Item Group ID
  - `lineItemId` string — Line Item ID
  - `title` string, required — Item Title
  - `description` string — Item Description
  - `quantity` string, required — Quantity
  - `rate` string, required — Rate per Item
  - `taxRate` string, required — Tax Rate
  - `rateDisplay` 'ABSOLUTE' | 'PERCENTAGE'
  - `externalIds` IntegrationExternalIdentifier[], required — IDs in external integrations
    - `key` 'Amazon_Redshift' | 'GoCardless' | 'Google_BigQuery' | 'Google_Sheets' | 'HubSpot' | 'NetSuite' | 'QuickBooks_Online' | 'Salesforce' | 'Slack' | 'Snowflake' | 'Stripe' | 'Xero' | 'Avalara' | 'Anrok' | 'Attio' | 'Numeral' | 'Rillet' | 'Sphere', required
    - `value` string, required
  - `servicePeriod` InclusiveDateRange — Service Period
    - `start` string, required — Start date, included in the whole range
    - `endInclusive` string, required — End date, included in the whole range
  - `revenueRecognitionMethod` 'STRAIGHT_LINE' | 'USAGE' | 'MILESTONE' | 'POINT_IN_TIME'
  - `revenueClassification` 'PREPAYMENT' | 'EARNED' | 'BURNDOWN'
  - `productId` string — Product ID
  - `invoiceLineItemIds` string[] — Invoice line items that will be refunded by the created credit note line item. Defaults to list of lineItemId if left empty

## Response `201`

Created

- Stable20240101ProductCreateCreditNoteLineItemResponseModel
  - `id` string, required — Credit Note Line Item ID
  - `creditNoteId` string, required — Credit Note Line Item ID
  - `groupId` string — Credit Note Line Item Group ID
  - `lineItemId` string — Line Item ID
  - `title` string, required — Item Title
  - `description` string — Item Description
  - `quantity` string, required — Quantity
  - `rate` string, required — Rate per Item
  - `taxRate` string, required — Tax Rate
  - `index` integer, required — Index (for maintaining order)
  - `priceId` string — Price ID
  - `netTotal` string, required — Net Total
  - `totalTax` string, required — Total Tax
  - `grossTotal` string, required — Gross Total
  - `rateDisplay` 'ABSOLUTE' | 'PERCENTAGE', required
  - `externalIds` IntegrationExternalIdentifier[], required — IDs in external integrations
    - `key` 'Amazon_Redshift' | 'GoCardless' | 'Google_BigQuery' | 'Google_Sheets' | 'HubSpot' | 'NetSuite' | 'QuickBooks_Online' | 'Salesforce' | 'Slack' | 'Snowflake' | 'Stripe' | 'Xero' | 'Avalara' | 'Anrok' | 'Attio' | 'Numeral' | 'Rillet' | 'Sphere', required
    - `value` string, required
  - `servicePeriod` InclusiveDateRange — Service Period
    - `start` string, required — Start date, included in the whole range
    - `endInclusive` string, required — End date, included in the whole range
  - `revenueRecognitionMethod` 'STRAIGHT_LINE' | 'USAGE' | 'MILESTONE' | 'POINT_IN_TIME'
  - `revenueClassification` 'PREPAYMENT' | 'EARNED' | 'BURNDOWN'
  - `productId` string — Product ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/sequencehq/apis/sequence.md) · [All operations](https://skmtc.net/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequencehq/sequence/versions/cae64b02699f/schema)