---
title: "Changes to Creates allocation for a specific credit note"
method: PUT
path: "/CreditNotes/{CreditNoteID}/Allocations"
---

# Changes to Creates allocation for a specific credit note

`PUT /CreditNotes/{CreditNoteID}/Allocations`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 61 revisions.

- **2026-09-03** `de95a0883a4a` — 2 info
- **2026-07-13** `57750919b957` — 2 info
- **2026-01-16** `e742d918b248` — 2 info
- **2025-09-15** `ab9dba3c8746` — 4 info
- **2024-09-16** `3aad5a420f76` — 14 info

## Changes

- **2026-09-03** `de95a0883a4a` — 2 info
  - the request optional property `Allocations/items/CreditNote/SentToContact` became not read-only
  - the response optional property `Allocations/items/CreditNote/SentToContact` became not read-only for the status `200`
- **2026-07-13** `57750919b957` — 2 info
  - added the optional property `Allocations/items/CreditNote/UpdatedDateUTCString` to the response with the `200` status
  - added the optional property `Allocations/items/Overpayment/UpdatedDateUTCString` to the response with the `200` status
- **2026-01-16** `e742d918b248` — 2 info
  - added the new optional request property `Allocations/items/Overpayment/Reference`
  - added the optional property `Allocations/items/Overpayment/Reference` to the response with the `200` status
- **2025-09-15** `ab9dba3c8746` — 4 info
  - added the new optional request property `Allocations/items/CreditNote/Contact/TaxNumberType`
  - added the new optional request property `Allocations/items/Overpayment/Contact/TaxNumberType`
  - added the optional property `Allocations/items/CreditNote/Contact/TaxNumberType` to the response with the `200` status
  - added the optional property `Allocations/items/Overpayment/Contact/TaxNumberType` to the response with the `200` status
- **2024-09-16** `3aad5a420f76` — 14 info
  - added the new optional request property `Allocations/items/CreditNote/InvoiceAddresses`
  - added the new optional request property `Allocations/items/CreditNote/LineItems/items/SalesTaxCodeId`
  - added the new optional request property `Allocations/items/CreditNote/LineItems/items/TaxBreakdown`
  - added the new optional request property `Allocations/items/CreditNote/LineItems/items/Taxability`
  - added the new optional request property `Allocations/items/Overpayment/LineItems/items/SalesTaxCodeId`
  - added the new optional request property `Allocations/items/Overpayment/LineItems/items/TaxBreakdown`
  - added the new optional request property `Allocations/items/Overpayment/LineItems/items/Taxability`
  - added the optional property `Allocations/items/CreditNote/InvoiceAddresses` to the response with the `200` status
  - added the optional property `Allocations/items/CreditNote/LineItems/items/SalesTaxCodeId` to the response with the `200` status
  - added the optional property `Allocations/items/CreditNote/LineItems/items/TaxBreakdown` to the response with the `200` status
  - added the optional property `Allocations/items/CreditNote/LineItems/items/Taxability` to the response with the `200` status
  - added the optional property `Allocations/items/Overpayment/LineItems/items/SalesTaxCodeId` to the response with the `200` status
  - added the optional property `Allocations/items/Overpayment/LineItems/items/TaxBreakdown` to the response with the `200` status
  - added the optional property `Allocations/items/Overpayment/LineItems/items/Taxability` to the response with the `200` status

---

[Operation](https://skmtc.dev/xeroapi/apis/xero-accounting-api/docs/CreditNotes/:CreditNoteID/Allocations/put.md) · [API](https://skmtc.dev/xeroapi/apis/xero-accounting-api.md) · [Page](https://skmtc.dev/xeroapi/apis/xero-accounting-api/changes/CreditNotes/:CreditNoteID/Allocations/put)