Book Appointment (POST)

Resource

/connect/health/appointment-management/appointment

Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org.

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/health/appointment-management/appointment

HTTP Methods

POST

Request Body for POST LS

{
  "startDate": "2013-12-10T09:00:00Z",
  "endDate": "2013-12-10T11:00:00Z",
  "workTypeId": "<workTypeId>",
  "channelId": "<channelId>",
  "comment": "Further expand on the results of the MRI and determine the next actions that may be appropriate.",
    "participants": [
    {
      "reference": "Patient/<patientId>"
    },
    {
      "reference": "Facility/<facilityId>"
    },
    {
      "reference": "Practitioner/<healthcarePractitionerId>",
      "isReferenceRequired": true
    }
  ]
}

Request Body for POST (EHR - External System, Like Cerner, Epic and Others)

{
  "startDate": "2013-12-10T09:00:00Z",
  "endDate": "2013-12-10T11:00:00Z",
  "workTypeId": "<workTypeId>",
  "channelId": "<channelId>",
  "sourceSystem": "cerner",
  "comment": "Further expand on the results of the MRI and determine the next actions that may be appropriate.",
  "appointmentTypes": [
	"FOLLOWUP"
  ],
  "serviceCategories": [
    "serviceCategoryCode1",
    "serviceCategoryCode2"
  ],
  "serviceTypes": [
    "serviceTypeCode1",
    "serviceTypeCode2"
  ],
  "specialties": [
    "specialityCode"
  ],
  "slots": [
    {
      "id": "24477854-21304876-62852027-2",
      "reference": "<healthcarePractitionerId>" - matches with the reference of practitioner within participants
    }
  ],
  "participants": [
    {
      "reference": "Patient/<patientId>"
    },
    {
      "reference": "Facility/<facilityId>"
    },
    {
      "reference": "Practitioner/<healthcarePractitionerId>",
      "isReferenceRequired": true
    }
  ]
}

Request Parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`appointmentTypes`	Array	Type of the appointment.	Required, if none of the following are provided: `workTypeId` `serviceTypes` `serviceCategories`	65.0
`channelId`	String	Engagement channel associated with the work type.	Required	65.0
`comment`	String	Additional text to aid in facilitating the appointment.	Optional	65.0
`endDate`	String	End date and time for the slots range.	Required	65.0
`participants`	Array	List of participants involved in the appointment. Patient and Facility are required. For single resource appointment, include either a `Device` (asset) or `Provider` or both for multi-resource appointment.	Required	65.0
`serviceCategories`	Array	List of broad categorizations of the service. An array of strings.	Required, if none of the following are provided: `workTypeId` `serviceTypes` `appointmentType`	65.0
`serviceTypes`	Array	List of specific services to be performed. An array of strings.	Required, if none of the following are provided: `workTypeId` `appointmentType` `serviceCategories`	65.0
`slots`	Array	List of references to the slots the appointment is filling.	Required, if the appointment is for an external resource.	65.0
`sourceSystem`	String	Source system associated with the appointment type, service type or service category.	Required, if `workTypeId` is not provided but either `appointmentType`, `serviceTypes`, or `serviceCategories` is.	65.0
`specialties`	Array	List of the specialties of a practitioner required for the service.	Optional	65.0
`startDate`	String	Start date and time for the slots range.	Required	65.0
`timeZone`	String	Timezone in which the appointment is updated.	Optional	65.0
`workTypeId`	String	Work type associated with the resource.	Required	65.0

Response Body for POST

Book Appointment Output