Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Update Appointment Action

Update an existing appointment.

This action is available in API version 65.0 and later.

Supported REST HTTP Methods

URI: /services/data/67.0/connect/health/appointment-management/appointment/{id}
Formats: JSON, XML
HTTP Methods: PUT
Authentication: Authorization: Bearer token

Inputs

Input	Details
appointmentTypes	Type Array Description Type of appointment, such as Follow-up. Required, if none of the workTypeId, serviceTypes, or serviceCategories are provided.
channelId	Type String Description Engagement channel associated with the appointment. Required, if an engagement channel is configured for a visit type.
comment	Type String Description Notes associated with the appointment. The maximum length is 256 characters.
description	Type String Description Description of the appointment.
endDate	Type String Description End time of the appointment.
id	Type String Description Required The unique identifier of the appointment to update. This is part of the request URL.
participants	Type Array Required Description List of participants involved in the appointment. For single resource appointment, include either a Device (asset) or a Provider. For multi-resource appointment, include both.
serviceCategories	Type Array Description List of service categories performed during the appointment. Required, if none of the workTypeId, serviceTypes, or appointmentType are provided.
serviceTypes	Type Array Description A list of specific services to be performed during this appointment. Required, if none of the workTypeId, appointmentType, or serviceCategories are provided.
slots	Type Array Required Required, if the appointment is being booked for an external resource. Description A list of references to the slots that this appointment is filling.
sourceSystem	Type String Description Required, if workTypeId is not provided. External system defined in Salesforce, such as `cerner`.
specialties	Type Array Description A list of the specialties of a practitioner that would be required to perform the service requested in this appointment.
startDate	Type String Description Start time of the appointment.
timeZone	Type String Description Timezone in which the appointment is booked.
workTypeId	Type String Description Visit type associated with the appointment. Required, if none of the appointmentType, serviceTypes, or serviceCategories are provided.

Outputs

Output	Details
id	Type String Description ID of the appointment.
isSuccess	Type Boolean Description Indicates whether the appointment was updated successfully (true) or not (false).
status	Type String Description Status of the appointment, such as Scheduled or Rejected.
errorMessages	Type Array Description List of errors, if any.

Example

PUT

This sample request is for the Update Appointment action.

1{
2  "inputs": [
3    {
4      "id": "08pxx000000Axq6xxC",
5      "workTypeId": "08qxx000000Axq6xxC",
6      "channelId": "0eFSG000000NNOV2A0",
7      "description": "Discussion",
8      "startDate": "2025-07-21T18:00:00.000Z",
9      "endDate": "2025-07-21T18:30:00.000Z",
10      "comment": "Payload for the internal salesforce system",
11      "participants": [
12        {
13          "reference": "Patient/001xx000012udqQxxQ"
14        },
15        {
16          "reference": "Practitioner/0bSxx0000005JoaxxE",
17          "isReferenceRequired": true
18        },
19        {
20          "reference": "Facility/001xx000012udqhxxA"
21        }
22      ]
23    }
24  ]
25}

This sample response is for the Update Appointment action.

1[
2  {
3    "id": "08pxx000000Axq6xxC",
4    "isSuccess": true,
5    "status": "Scheduled",
6    "errorMessages": []
7  }
8]

Agentforce Health Developer Guide

Update Appointment Action

Supported REST HTTP Methods

Inputs

Outputs

Example