---
title: "Post an appointment into a valid diary allocation"
method: POST
path: "/v3/diary/{shortName}/appointment"
tags: ["DiaryController"]
---

# Post an appointment into a valid diary allocation

`POST /v3/diary/{shortName}/appointment`

## Path parameters

- `shortName` string, required

## Query parameters

- `propertyIdentifier` string[], required
- `lettings` boolean

## Request body

- DiaryAppointmentDetails — Submission Model - Structure to submit the appointment details
  - `AllocationDetails` DiaryBookingModel — Represents a viewing booking slot
    - `Start` string, date-time — The start time of the booking
    - `End` string, date-time — The end time of the booking
    - `StaffName` string — The name of the staff member this booking is with
    - `StaffID` string — The unique ID of the staff member this booking is with
  - `AppointmentType` string — The Appointment Type ID
  - `Subject` string — The subject of the appointment
  - `ExtraComments` string — Additional appointment comments
  - `Guests` DiaryGuestDetails[] — A collection of guests linked to the appointment. If none leave empty
    - `OID` string — The unique identifier of a user, only submit this is known
    - `Forename` string — Forename
    - `Surname` string — Surname
    - `MobilePhone` string — Mobile phone
    - `EmailAddress` string — Email address
    - `AllowMarketingCorrespondence` boolean — Marketing Correspondence Preferences

## Response `200`

OK

- string

---

[API](https://skmtc.net/letmc/apis/agentos-api-v3-diary-call-group.md) · [All operations](https://skmtc.net/letmc/apis/agentos-api-v3-diary-call-group/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letmc/agentos-api-v3-diary-call-group/versions/9e518bf9a2f6/schema)