agentOS API V3, Diary Call Group
The agentOS API V3 Diary Call Group lets a client retrieve available appointment allocations and manage diary appointments—creating, reading, updating, deleting, canceling, and submitting feedback—while also providing endpoints to list appointment types, company branches, and retrieve appointments filtered by date range and type.
Admin: update documentationGET
/v3/diary/{shortName}/allocations
Get a list of all available allocations for a date + 7 days for a specified appointment type
shortName ( path , required ) — The unique client short-namepreferredDate ( query , required ) — The date to search fromappointmentType ( query , required ) — The unique appointment type identifierlettings ( query ) — Sales or Lettings property?propertyIdentifier ( query ) — The unique property identifier (Sales or Lettings) determines branch and property typebranchID ( query ) — Branch ID to check appointments (required if no property submitted)DELETE
/v3/diary/{shortName}/appointment
Delete an existing appointment using its unique identifier
shortName ( path , required ) — The unique client short-nameappointmentID ( query , required ) — The unique appointment idGET
/v3/diary/{shortName}/appointment
Get an appointment by ID
shortName ( path , required ) — Company short nameappointmentID ( query , required ) — Appointment IDPOST
/v3/diary/{shortName}/appointment
Post an appointment into a valid diary allocation
shortName ( path , required ) — The unique client short-namepropertyIdentifier ( query , required ) — The unique property identifier (Sales or Lettings)lettings ( query ) — Sales or Lettings property?PUT
/v3/diary/{shortName}/appointment
Update an existing appointment using its unique identifier
shortName ( path , required ) — The unique client short-nameappointmentID ( query , required ) — The unique appointment idlettings ( query ) — Sales or Lettings property?AllowMarketingCorrespondence ( query ) — Sales or Lettings property?POST
/v3/diary/{shortName}/appointment/feedback
Submit appointment feedback
shortName ( path , required ) — The unique client short-namePATCH
/v3/diary/{shortName}/appointment/{appointmentID}/cancel
Cancel an existing appointment using its unique identifier
shortName ( path , required ) — The unique client short-nameappointmentID ( path , required ) — The unique appointment idGET
/v3/diary/{shortName}/appointmentsbetweendates
A collection of diary appointments linked to a company filtered between specific dates and by appointment type
shortName ( path , required ) — The unique client short-namebranchID ( query , required ) — The unique ID of the BranchstartDate ( query , required ) — The search from dateendDate ( query , required ) — The search to dateappointmentTypesToSearch ( query , required ) — The appointment IDs to search foroffset ( query , required , offset ) — The index of the first item to returncount ( query , required , limit ) — The maximum number of items to return (up to 1000 per request)GET
/v3/diary/{shortName}/appointmenttypes
A collection of all diary appointment types
shortName ( path , required ) — The unique client short-nameoffset ( query , required , offset ) — The index of the first item to returncount ( query , required , limit ) — The maximum number of items to return (up to 1000 per request)GET
/v3/diary/{shortName}/company/branches
All branches defined for a company
shortName ( path , required ) — The unique client short-nameoffset ( query , required , offset ) — The index of the first item to returncount ( query , required , limit ) — The maximum number of items to return (up to 1000 per request)GET
/v3/diary/{shortName}/company/branches/{branchID}
Get a specific branch given its unique Object ID (OID)
shortName ( path , required ) — The unique client short-namebranchID ( path , required ) — The unique ID of the BranchGET
/v3/diary/{shortName}/recurringappointment
Retrieves all recurring appointments:-
shortName ( path , required ) — The unique client short-namebranchID ( query , required ) — The unique ID of the BranchappointmentTypesToSearch ( query , required ) — The appointment IDs to search foroffset ( query , required , offset ) — The index of the first item to returncount ( query , required , limit ) — The maximum number of items to return (up to 1000 per request)GET
/v3/diary/{shortname}/{branchID}/guest/search
Match Guest Parameters with existing applicants
shortname ( path , required ) branchID ( path , required ) forename ( query , required ) emailaddress ( query , required ) surname ( query , required ) offset ( query , required , offset ) count ( query , required , limit )
13 endpoints auto-detected
Authentication
This API uses an API key, passed in the "ApiKey" header. No OAuth required.
curl -X GET \
"https://live-api.letmc.com/v3/diary/{shortName}/allocations" \
-H "ApiKey: YOUR_API_KEY" live-api.letmc.com · HTTPS only