# Create credit note line

> Creates a new line item on a credit note in draft status.

`POST https://api.light.inc/v1/credit-notes/{creditNoteId}/lines`

## Note

Only while the credit note is DRAFT ( CREDIT_NOTE_CANNOT_BE_MODIFIED ). Amounts are { amount, dcSign } objects, normally credits ( C ). costCenterId cannot be set through the API.

## Authorization

- API key
- Bearer token

See https://light.inc/docs/getting-started/authentication.

## Path parameters

- `creditNoteId` (string, uuid, required)

## Request body

`application/json;charset=UTF-8`

- `netTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.
- `grossTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.
- `taxTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.
- `customProperties.valueIds` — Catalogue value ids for this group. Required; send `[]` (with an empty `inlineValues`) to clear the group. `SINGLE_SELECT` and `MULTI_SELECT` groups accept nothing else. See [Custom properties on writes](/docs/getting-started/pagination-filtering-errors#custom-properties-on-writes).
- `customProperties.inlineValues` — Literal values for `TEXT`, `NUMERIC`, `BOOLEAN` and `DATE` groups, as strings (`yyyy-MM-dd` for dates). Rejected on select groups with `CUSTOM_PROPERTY_VALUE_TYPE_MISMATCH`. See [Custom properties on writes](/docs/getting-started/pagination-filtering-errors#custom-properties-on-writes).

```json
{
  "netTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "grossTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "taxTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "description": "string",
  "ledgerTaxId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ledgerAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customProperties": [
    {
      "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "valueIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "inlineValues": [
        "string"
      ]
    }
  ],
  "accrualTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accrualStartDate": "2026-01-15",
  "accrualEndDate": "2026-01-15"
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders, and fields that exclude each other are all shown. Do not send it unchanged.

## Response

- `grossTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.
- `netTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.
- `taxTransactionAmount.amount` — Unsigned integer in minor units. The direction is in `dcSign`; a negative value is rejected.

```json
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "creditNoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "grossTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "netTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "description": "string",
  "ledgerTaxId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taxTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "ledgerAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "costCenterId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z",
  "accrualTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accrualStartDate": "2026-01-15",
  "accrualEndDate": "2026-01-15",
  "accrualDefaultDuration": 0
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders.

## Code

```bash
curl -X POST "https://api.light.inc/v1/credit-notes/3c90c3cc-0d44-4b50-8888-8dd25736052a/lines" \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "netTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "grossTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "taxTransactionAmount": {
    "amount": 100000,
    "dcSign": "D"
  },
  "description": "string",
  "ledgerTaxId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ledgerAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customProperties": [
    {
      "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "valueIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "inlineValues": [
        "string"
      ]
    }
  ],
  "accrualTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accrualStartDate": "2026-01-15",
  "accrualEndDate": "2026-01-15"
}'
```

---

Full page: https://light.inc/docs/api-reference/v1--credit-notes/create-credit-note-line · Index: https://light.inc/docs/llms.txt