Book Service Appointments

A service appointment is an appointment booked through Salesforce Scheduler. Use the service-appointments API to create an appointment.

1. On your website, create a page with a Create button on which you can show the appointment details for the user to review and book the appointment.

2. Link the Create button to a POST request on the service-appointments Connect API.

   Resource URI

   Where YOUR_INSTANCE is a variable.

   For an Account User

   Sample Request

   This sample calls the service-appointments API to create the appointment record for an account user.

   The parentRecordId field is required. Pass the account ID as parentRecordId in the input request body.

   Sample Response

   The API returns the service appointment ID and the assigned service resources.

   For a Guest User

   Sample Request

   This sample calls the service-appointments API to create the appointment record for a guest user.

   The lead field is required. Pass the guest user details, including the first name, last name, email address, and phone number as lead in the input request body.

   Sample Response

   The API returns the service appointment ID and the assigned service resources.

3. If the service appointment creation is successful, then show the user a confirmation message.

   Here’s a sample confirmation page.