---
title: "Changes to Creates a new file association"
method: POST
path: "/Files/{FileId}/Associations"
---

# Changes to Creates a new file association

`POST /Files/{FileId}/Associations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 56 revisions.

- **2026-04-24** `a5ea94fb50fd`: 4 info
- **2024-06-18** `bb86098f8245`: 3 breaking, 15 info
- **2024-06-18** `d277dd2accff`: 2 breaking, 15 warning
- **2024-06-03** `d599b701a104`: 3 breaking, 15 info
- **2024-02-01** `fb29d2ec1038`: 1 breaking

## Changes

- **2026-04-24** `a5ea94fb50fd`: 4 info
  - added the new optional request property `AssociationDateUtc`
  - added the new optional request property `CreatedDateUtc`
  - added the optional property `AssociationDateUtc` to the response with the `201` status
  - added the optional property `CreatedDateUtc` to the response with the `201` status
- **2024-06-18** `bb86098f8245`: 3 breaking, 15 info
  - added the new required `header` request parameter `xero-tenant-id` to all path's operations
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `201`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `FileId`
  - added the new optional request property `Name`
  - added the new optional request property `ObjectGroup`
  - added the new optional request property `ObjectId`
  - added the new optional request property `ObjectType`
  - added the new optional request property `SendWithObject`
  - added the new optional request property `Size`
  - added the optional property `FileId` to the response with the `201` status
  - added the optional property `Name` to the response with the `201` status
  - added the optional property `ObjectGroup` to the response with the `201` status
  - added the optional property `ObjectId` to the response with the `201` status
  - added the optional property `ObjectType` to the response with the `201` status
  - added the optional property `SendWithObject` to the response with the `201` status
  - added the optional property `Size` to the response with the `201` status
- **2024-06-18** `d277dd2accff`: 2 breaking, 15 warning
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `201`
  - deleted the `header` request parameter `Idempotency-Key`
  - removed the request property `FileId`
  - removed the request property `Name`
  - removed the request property `ObjectGroup`
  - removed the request property `ObjectId`
  - removed the request property `ObjectType`
  - removed the request property `SendWithObject`
  - removed the request property `Size`
  - removed the optional property `FileId` from the response with the `201` status
  - removed the optional property `Name` from the response with the `201` status
  - removed the optional property `ObjectGroup` from the response with the `201` status
  - removed the optional property `ObjectId` from the response with the `201` status
  - removed the optional property `ObjectType` from the response with the `201` status
  - removed the optional property `SendWithObject` from the response with the `201` status
  - removed the optional property `Size` from the response with the `201` status
- **2024-06-03** `d599b701a104`: 3 breaking, 15 info
  - added the new required `header` request parameter `xero-tenant-id` to all path's operations
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `201`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `FileId`
  - added the new optional request property `Name`
  - added the new optional request property `ObjectGroup`
  - added the new optional request property `ObjectId`
  - added the new optional request property `ObjectType`
  - added the new optional request property `SendWithObject`
  - added the new optional request property `Size`
  - added the optional property `FileId` to the response with the `201` status
  - added the optional property `Name` to the response with the `201` status
  - added the optional property `ObjectGroup` to the response with the `201` status
  - added the optional property `ObjectId` to the response with the `201` status
  - added the optional property `ObjectType` to the response with the `201` status
  - added the optional property `SendWithObject` to the response with the `201` status
  - added the optional property `Size` to the response with the `201` status
- **2024-02-01** `fb29d2ec1038`: 1 breaking
  - request body became required

---

[Operation](https://skmtc.dev/xeroapi/apis/xero-files-api/docs/Files/:FileId/Associations/post.md) - [API](https://skmtc.dev/xeroapi/apis/xero-files-api.md) - [Page](https://skmtc.dev/xeroapi/apis/xero-files-api/changes/Files/:FileId/Associations/post)