Skip to main content
PATCH
/
appointments
/
{appointmentId}
Change appointment status
curl --request PATCH \
  --url https://api.mijnklantportaal.nl/v1/appointments/{appointmentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "scheduled"
}'
{
  "id": "apt_abc12346def678",
  "customerId": "cst_abc12345def678",
  "attendeeName": "John Doe",
  "attendeeEmail": "john.doe@example.com",
  "startsAt": "2025-03-05T16:00:00+02:00",
  "endsAt": "2025-03-05T16:30:00+02:00",
  "status": "scheduled",
  "onlineMeetingLink": "https://meet.google.com/abc-123",
  "createdAt": "2025-03-04T17:23:14+02:00"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
appointmentId
string
required

ID of the appointment to change

Body

application/json
​
status
string
required

The new status for the appointment. Can be scheduled or canceled.

Example:

"scheduled"

Response

The changed appointment

Appointment

​
id
string

ID of the appointment, always starting with apt_.

Example:

"apt_abc12346def678"

​
customerId
string | null

ID of the Customer involved in this appointment, when the case

Example:

"cst_abc12345def678"

​
attendeeName
string

Name of the attendee of the meeting

Example:

"John Doe"

​
attendeeEmail
string

Emailaddress of the attendee of the meeting

Example:

"john.doe@example.com"

​
startsAt
string

Date and time when the appointment starts, written in ATOM format.

Example:

"2025-03-05T16:00:00+02:00"

​
endsAt
string

Date and time when the appointment ends, written in ATOM format.

Example:

"2025-03-05T16:30:00+02:00"

​
status
string

Current status of the appointment. Possible values are scheduled, canceled, and pending.

Example:

"scheduled"

​
onlineMeetingLink
string | null

Link to the online meeting of the connected integration, when available

Example:

"https://meet.google.com/abc-123"

​
createdAt
string

Date and time when the appointment is added to MijnKlantportaal, not matter of the status. Written in ATOM format.

Example:

"2025-03-04T17:23:14+02:00"