---
schema_version: "1"
id: ec2d91d2150d5f9e96fd71d4153d7a986585715655081b3d018e31d3b7f99299
title: ConnectApi.ServiceAppointmentInput
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_service_appointment.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_service_appointment.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e0ef16558033709be882d34b6a81449209616b56bb677800f269f590d688e91c
description: Contains information about the service appointment.
---
# ConnectApi.ServiceAppointmentInput

Contains information about the service appointment.

<table class="featureTable sort_table" summary="">
          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d729861e27">Property</th>
              <th class="featureTableHeader vertical-align-top " id="d729861e29">Type</th>
              <th class="featureTableHeader vertical-align-top " id="d729861e31">Description</th>
              <th class="featureTableHeader vertical-align-top " id="d729861e33">Required or Optional</th>
              <th class="featureTableHeader vertical-align-top " id="d729861e35">Available Version</th>
            </tr>
          </thead>
          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">additionalInformation</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Additional details about the service appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">appointmentMode</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/connectAPI_enums.htm" title="Enums specific to the ConnectApi namespace.">ConnectApi.SvcApptModeEnum</a></td>

              <td class="entry" headers="d729861e31" data-title="Description">Mode of the service appointment.<ul class="ul bulletList">
                  <li class="li">
                    <samp class="codeph apex_code">Group</samp>— Service appointment mode is Group.
                  </li>
                  <li class="li">
                    <samp class="codeph apex_code">Regular</samp>— Default mode of service appointment.
                  </li>
                </ul>
              </td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">60.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">appointmentType</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Type of the appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">attendeeLimit</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">Integer</td>

              <td class="entry" headers="d729861e31" data-title="Description">Maximum number of customers that’s allowed to attend the service
                appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Required if the appointment mode is Group.</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">60.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">city</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Name of the city.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">comments</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Comments about the appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">contactId</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">ID of the contact associated with the parent record.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">country</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Name of the country.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">description</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Description of the appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">engagementChannelTypeId</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">
                <span class="ph" id="channelType"><a name="channelType"><!-- --></a>ID of the engagement channel type to associate with the
                  appointment.</span>
                <p class="p">You can use engagement channel type only if:</p>
                <ul class="ul bulletList">
                  <li class="li">
                    <strong class="ph uicontrol">Schedule Appointments Using Engagement Channels</strong> is
                    enabled in Salesforce Scheduler Settings in your Salesforce org.
                  </li>

                  <li class="li">Shifts are defined in the scheduling policy. For more information on setting
                    up shifts in the scheduling policy, see <a class="xref" href="https://help.salesforce.com/s/articleView?id=platform.ls_use_shifts_to_determine_time_slots.htm&amp;type=5&amp;language=en_US" target="_blank" title="HTML (New Window)">Define Shift Rules in
                      Scheduling Policy</a>. Engagement channel types are not supported with operating hours rules in the scheduling policy. </li>

                </ul>
              </td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">56.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">extendedFields</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list" title="Contains methods for the List collection type.">List</a>&lt;<samp class="codeph apex_code"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_extended_field.htm" title="Contains information about the extended field.">ConnectApi.ExtendedFieldInput</a></samp>&gt;
              </td>

              <td class="entry" headers="d729861e31" data-title="Description">Values to add to any of the fields, including custom fields.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">parentRecordId</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">ID of the parent record associated with the account.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Required if <samp class="codeph apex_code">lead</samp> isn’t
                provided.</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">postalCode</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Postal code of the city.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">schedEndTime</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">Datetime</td>

              <td class="entry" headers="d729861e31" data-title="Description">Time at which the appointment is scheduled to end.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">schedStartTime</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">Datetime</td>

              <td class="entry" headers="d729861e31" data-title="Description">Time at which the appointment is scheduled to start.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">serviceTerritoryId</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">ID of the service territory associated with the service appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">state</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Name of the state.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">street</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Name of the street.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">subject</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">Short phrase describing the appointment.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d729861e27 d729861e35" data-title="Property"><samp class="codeph apex_code">workTypeId</samp></td>

              <td class="entry" headers="d729861e29" data-title="Type">String</td>

              <td class="entry" headers="d729861e31" data-title="Description">ID of the work type associated with the service appointment. If specified, it
                is added to the service appointment record.</td>

              <td class="entry" headers="d729861e33" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d729861e27 d729861e35" data-title="Property">53.0</td>

            </tr>

          </tbody>
        </table>