---
title: "Create a credit note"
method: POST
path: "/api/credit-notes"
tags: ["Credit Notes"]
---

# Create a credit note

`POST /api/credit-notes`

Create a credit note against an invoice. Starts in DRAFT status.

## Request body

- CreateCreditNoteDto
  - `invoiceId` string, required — Invoice ID to credit against
  - `customerId` string, required — Customer ID
  - `amount` number, required — Credit amount
  - `currency` string, required — Currency
  - `reason` 'DUPLICATE' | 'PRODUCT_UNSATISFACTORY' | 'ORDER_CHANGE' | 'OTHER', required
  - `metadata` object — Additional metadata
  - `status` 'DRAFT' | 'FINALIZED' | 'VOIDED' — Override status for imports
  - `createdAt` string — Backdate createdAt (ISO 8601). For data imports.

## Response `201`

Credit note created

- CreditNoteResponse
  - `id` string, required
  - `invoiceId` string, required
  - `customerId` string, required
  - `amount` string, required — Decimal amount as string
  - `currency` string, required
  - `reason` 'DUPLICATE' | 'PRODUCT_UNSATISFACTORY' | 'ORDER_CHANGE' | 'OTHER', required
  - `status` 'DRAFT' | 'FINALIZED' | 'VOIDED', required
  - `metadata` object
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `400` — Amount exceeds invoice total or invalid data
- `404` — Invoice or customer not found

---

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