---
title: "Create a credit-note draft"
method: POST
path: "/companies/{companyId}/credit-notes"
tags: ["Credit Notes"]
---

# Create a credit-note draft

`POST /companies/{companyId}/credit-notes`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/credit-notes`
- Auth: HTTP bearer

Temporarily unavailable in production and QA. No credit note or accounting entry is created while durable Model A persistence is absent.

## Request body

- CreateCreditNoteInput
  - `type` 'received' | 'issued', required
  - `number` string
  - `date` string, date, required
  - `counterpartyName` string, required
  - `description` string, required
  - `amountCents` integer, required
  - `currency` string
  - `appliedToInvoiceId` string, uuid

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `422`: Invalid credit-note input
- `503`: Durable Model A credit-note persistence is not available. The request creates no credit note, journal entry, reversal, or balance change.

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)