Scope appointments:read for reads · appointments:write for changes
Operations
| GET | /v1/appointments | List — see list |
| POST | /v1/appointments | Create — see create |
| GET | /v1/appointments/{id} | Read — see get |
| PATCH | /v1/appointments/{id} | Update — see update |
| DELETE | /v1/appointments/{id} | Delete — see delete |
Minimal create
curl -X POST https://api2.djcsystem.com/v1/appointments \
-H "Authorization: Bearer $DJC_TOKEN" -H "Content-Type: application/json" \
-d '{ "custName": "…", "custContact": "…", "startDate": "2026-09-10T02:00:00Z", "endDate": "2026-09-10T02:00:00Z", "timezone": "…" }'Fields
Fields you may send on create. Updatable marks fields accepted by PATCH. Anything not listed is server-owned or hidden.
| Field | Type | On create | Updatable |
|---|---|---|---|
name | string | optional | yes |
custName | string | required | yes |
custContact | string | required | yes |
custEmail | string | optional | yes |
description | string | optional | yes |
startDate | datetime | required | yes |
endDate | datetime | required | yes |
timezone | string | required | yes |
locationType | enum(in_person|phone|video) | optional | yes |
location | string | optional | yes |
duration | number | optional | yes |
eventTypeId | string | optional | yes |
notes | string | optional | yes |
sendReminder | boolean | optional | yes |
sendReminderToClient | boolean | optional | yes |
sendReminderToSelf | boolean | optional | yes |
Filters & sorting
| Filterable | eventTypeIdcustContactcustEmail |
| Sortable | startDatecreatedDatedate |
| Default order | startDate:asc |
Good to know
- `startDate`/`endDate` are ISO-8601 with offset. `timezone` is an IANA name such as `Asia/Kuala_Lumpur`.