--- schema_version: "1" id: 2509cb51edb921a9e847a702d83558584a6a03d591e903e1b6704e5f36ec6b45 title: TimeSlot collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_timeslot.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_timeslot.htm source_site: developer.salesforce.com content_type: documentation content_hash: 5c721b453745360dcea131e42fc693e8f64edb8332d01085f8ec01fe143c5d17 description: Represents a period of time on a specified day of the week during which work can be performed in Field Service, Salesforce Scheduler, or Workforce Engagement. Operating hours consist of one or more time slots. This object is available in API version 38.0 and later. --- # TimeSlot Represents a period of time on a specified day of the week during which work can be performed in Field Service, Salesforce Scheduler, or Workforce Engagement. Operating hours consist of one or more time slots. This object is available in API version 38.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), update(), upsert() ## Fields | Field Name | Details | | --- | --- | | DayOfWeek | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description The day of the week when the time slot takes place. | | EndTime | Type time Properties Create, Filter, Sort, Update Description The time when the time slot ends. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed. | | MaxAppointments | Type int Properties Create, Defaulted on create, Filter, Group, Nillable, Sort, Update Description Maximum number of appointments for a single time slot. Available in API version 47.0 and later. | | OperatingHoursId | Type reference Properties Create, Filter, Group, Sort Description The operating hours that the time slot belongs to. An operating hours’ time slots appear in the Operating Hours related list. This is a relationship field. Relationship Name OperatingHours Relationship Type Lookup Refers To OperatingHours | | StartTime | Type time Properties Create, Filter, Sort, Update Description The time when the time slot starts. | | RecordSetFilterCriteriaId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the recordset filter criteria selected for the time slot. This is a relationship field. Relationship Name RecordsetFilterCriteria Relationship Type Lookup Refers To RecordsetFilterCriteria | | TimeSlotNumber | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The name of the time slot. The name is auto-populated to a day and time format—for example, Monday 9:00 AM - 10:00 PM—but you can manually update it if you wish. | | Type | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description The type of time slot. Possible values are Normal and Extended. You may choose to use Extended to represent overtime shifts. | | WorkTypeGroupId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Work type group assigned to the time slot. Available in API version 47.0 and later. This is a relationship field. Relationship Name WorkTypeGroup Relationship Type Lookup Refers To WorkTypeGroup | ## Usage Operating hours are composed of time slots, which indicate the hours of operation for a particular day. After you create operating hours, create time slots for each day. For example, if the operating hours should be 8 AM to 5 PM Monday through Friday, create five time slots, one per day. To reflect breaks such as lunch hours, create multiple time slots in a day: for example, Monday 8:00 AM – 12:00 PM and Monday 1:00 PM – 5:00 PM. ![Tip](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note_tip.png) #### Tip Time slots don’t come with any built-in rules, but you can create Apex triggers that limit time slot settings in your org. For example, you may want to restrict the start and end times on time slots to half-hour increments, or to prohibit end times later than 8 PM. ## Associated Objects This object has the following associated objects. Unless noted, they are available in the same API version as this object. [TimeSlotChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.264.0.api.meta/api/sforce_api_associated_objects_change_event.htm) (API version 54.0) Change events are available for the object. [TimeSlotHistory](https://developer.salesforce.com/docs/atlas.en-us.264.0.api.meta/api/sforce_api_associated_objects_history.htm;) (API version 62.0) History is available for tracked fields of the object.