---
title: "Create a file note"
method: POST
path: "/file-notes"
tags: ["FileNotes"]
---

# Create a file note

`POST /file-notes`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/file-notes`
- Auth: `appAuth` (a scheme the document does not define)

Create a file note associated to the requested property, owners/contacts.
As a minimum a file note must be associated to either a property or a contact(s).

## Headers

- `AgencyRef` string, required

## Request body

- CreateFileNoteRequest
  - `negotiatorId` string, nullable: [Optional] The unique identifier of a negotiator
  - `propertyId` string, nullable: [Optional] The unique identifier of the property to associate to the file note
  - `tenancyId` string, nullable: [Optional] The unique identifier of the tenancy to associate to the file note
  - `ownerIds` string[], nullable: [Optional] The unique identifiers (contact id) of the property owner(s) to associate to the file note
  - `contactIds` string[], nullable: [Optional] The unique identifiers of additional contact(s) to associate to the file note
  - `title` string, nullable: [Optional] Title of the file note - not currently visible to users
  - `notes` string, nullable: [Required] The body/content of the file note
  - `updateLastContactedDate` boolean: When set to true the Last Contacted Date of Owners and Contacts will be updated
  - `fileNoteType` 'Unspecified' | 'DetailsToVendor' | 'DetailsApproved' | 'FileNote' | 'PhoneCall' | 'EMail', nullable: [Optional] The type of file note to create

## Response `201`

Returns the unique identifier of the newly created file note

- integer

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)