Skip to main content
POST
/
appointments
/
{appointment}
cURL
curl --request POST \
  --url https://api.caspen.com/v1/appointments/{appointment} \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_id": 123,
  "practitioner_id": 123,
  "service_id": 123,
  "client_id": 123,
  "client_package_id": 123,
  "case_id": 123,
  "starts_at": "2023-11-07T05:31:56Z",
  "ends_at": "2023-11-07T05:31:56Z",
  "note": "<string>",
  "confirmed": true,
  "room_id": 123,
  "vehicle_id": 123,
  "resource_ids": [
    123
  ]
}
'
{
  "id": "<string>",
  "location_id": "<string>",
  "practitioner_id": "<string>",
  "service_id": "<string>",
  "client_id": "<string>",
  "client_package_id": "<string>",
  "case_id": "<string>",
  "starts_at": "<string>",
  "ends_at": "<string>",
  "duration": 123,
  "status": "<string>",
  "confirmed": true,
  "confirmed_at": "<string>",
  "room_id": "<string>",
  "vehicle_id": "<string>",
  "resource_ids": [
    "<string>"
  ],
  "note": "<string>",
  "cancellation_reason_id": "<string>",
  "cancellation_note": "<string>",
  "cancelled_at": "<string>",
  "created_at": "<string>"
}

Path Parameters

​
appointment
string
required

The appointment ID

Body

application/json
​
location_id
integer
​
practitioner_id
integer
​
service_id
integer
​
client_id
integer
​
client_package_id
integer | null
​
case_id
integer | null
​
starts_at
string<date-time>
​
ends_at
string<date-time>
​
note
string | null
Maximum string length: 255
​
confirmed
boolean
​
room_id
integer | null
​
vehicle_id
integer | null
​
resource_ids
integer[]

Response

AppointmentResource

​
id
string

The appointment's unique identifier.

​
location_id
string

The location identifier where the appointment takes place.

​
practitioner_id
string

The practitioner identifier who provides the service.

​
service_id
string

The service identifier being provided.

​
client_id
string

The client identifier who has the appointment.

​
client_package_id
string | null

The client package identifier if this appointment uses a package.

​
case_id
string | null

The case identifier if this appointment is part of a case.

​
starts_at
string

The appointment start time (ISO 8601).

​
ends_at
string

The appointment end time (ISO 8601).

​
duration
integer

The appointment duration in minutes.

​
status
string

The appointment status.

​
confirmed
boolean | null

Whether the appointment is confirmed.

​
confirmed_at
string | null

When the appointment was confirmed (ISO 8601).

​
room_id
string | null

The room identifier where the appointment takes place.

​
vehicle_id
string | null

The vehicle identifier if transportation is involved.

​
resource_ids
string[]

The IDs of resources required for this appointment.

​
note
string | null

The appointment note.

​
cancellation_reason_id
string | null

The cancellation reason identifier if cancelled.

​
cancellation_note
string | null

The cancellation note if cancelled.

​
cancelled_at
string | null

When the appointment was cancelled (ISO 8601).

​
created_at
string

The timestamp when the appointment was created (ISO 8601).