---
schema_version: "1"
id: 97c1da76c3c1d8f1fa5adfe30351b2b688c12bcbc6bd6d3bde879400352d9096
title: ServiceAppointment
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/workdotcom_dev/guides/wkfsl-sforce-api-objects-serviceappointment.md
canonical_url: https://developer.salesforce.com/docs/service/workdotcom-dev/guide/wkfsl-sforce-api-objects-serviceappointment.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: f1f5d383d69ddceda1a45720c0bbf7426d5affe887dd16783d5b4e2df0bc51a1
products:
  - Work.com Developer Guide
  - Service Cloud Developer Content
---

# ServiceAppointment

Represents available shifts for a workplace and confirmed shifts for service resources. Service appointments are linked to planned occupancy and, when confirmed, to a service resource (a person). This object is available in API version 38.0 and later.

For standard fields on the ServiceAppointment object, see [Object Reference - ServiceAppointment](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_serviceappointment.htm).

The following Status values are relevant to Shift Management:

- None—The initial state; the appointment is not linked to a service resource and it represents an available shift.
- Scheduled—The appointment is linked to a service resource (through the [AssignedResource](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_assignedresource.htm) junction object). The appointment represents a shift that is tentatively filled by that service resource.
- Dispatched—The appointment is now shared with the service resource and the service resource is notified that they are assigned to that shift.
- In Progress—The service resource accepted the shift.

The service resource can also reject a shift. In that case, the [AssignedResource](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_assignedresource.htm) record is deleted and the appointment represents an available shift again.

## Supported Calls

`create()`, `delete()`, `describeLayout()`, `describeSObjects()`, `getDeleted()`, `getUpdated()`, `query()`, `retrieve()`, `search()`, `undelete()`, `update()`, `upsert()`

## Custom Fields

| Field                       | Type      | Properties                                                         | Description                                                                                                                                          |
| --------------------------- | --------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| wkfsl\_\_Facility_Plan\_\_c | reference | Create, Filter, Group, Nillable, Sort, Update                      | The facility plan. This has information such as maximum occupancy information for a location. This field is available in API version 48.0 and later. |
| wkfsl\_\_Reject_type\_\_c   | picklist  | Create, Filter, Group, Nillable, Restricted picklist, Sort, Update | This field is reserved for future use.                                                                                                               |