Create Credit note

Creates a new record.

POSThttps://api.tracksales.co/v1/credit-notes

Required scope: credit_notes:create

Request URL: https://api.tracksales.co/v1/credit-notes

Body Params

customerIdstringrequired

Customer UUID

itemsarrayrequired

Line items

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Credit-notes was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/v1/credit-notes' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"customerId":42,"date":"2026-07-02","items":[{"itemId":101,"quantity":1,"unitPrice":2000}]}'

{
    "success": true,
    "data": {
        "credit_note_id": 401,
        "customerId": 42,
        "total": 2000,
        "status": "open"
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Credit-notes not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}