Create an appointment

Create a new appointment for a person. Schedule meetings, showings, consultations, and other calendar events.

Example:

{
  "personId": "person-uuid",
  "title": "Property Showing",
  "description": "Show 123 Main St property",
  "location": "123 Main St, City, State",
  "startsAt": "2025-10-15T14:00:00Z",
  "endsAt": "2025-10-15T15:00:00Z",
  "type": "showing"
}

Required fields: personId, title, startsAt

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

ID of the person this appointment is for

uuid

User assigned to this appointment (defaults to current user)

string
required
string | null
string | null
boolean

True if this is an all-day event

string | null

Appointment type (showing, consultation, meeting, etc.)

date-time
required

Start date/time (ISO 8601 format)

date-time | null

End date/time (ISO 8601 format)

Responses
201

appointment created

401

unauthorized

404

person not found

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json