Schedule Object


A collection of events associated with a specific entity, such as a Bookings service, or Bookings resource. Schedules can also serve as templates for the events they manage, setting default values like a default location.

Properties
idstringRead-onlyformat GUID

Schedule ID.


externalIdstringformat GUID

External ID. You can't update the external ID.

If the schedule belongs to a Bookings staff member, identical to the ID of the resource. If the schedule belongs to a Bookings service, identical to the ID of the service.


namestringminLength 1maxLength 200

Schedule name.

Min: 1 character Max: 200 characters


statusstringRead-only

Schedule status.

Supported values:

  • ACTIVE: You can add events to the schedule or update its fields.
  • CANCELLED: You can't add events to the schedule or update its fields.

Default: ACTIVE


timeZonestringminLength 1maxLength 150

Time zone the schedule is associated with in IANA tz database format. For example, America/New_York.

Default: timeZone specified in the business site properties.

Min: 1 character Max: 150 characters


businessTimeZoneEnabledboolean

Whether the schedule's timeZone is automatically synced from timeZone of the business site properties.

Default: true


defaultTitlestringminLength 1maxLength 200

Default title for events that are added to the schedule.

Min: 1 character Max: 200 characters


defaultLocationDefaultLocation

Default location for events that are added to the schedule.


defaultCapacityintegerminimum 0format int32

Default totalCapacity for events that are added to the schedule.

Min: 0


defaultConferencingDetailsDefaultConferencingDetails

Default conferencingDetails for events that are added to the schedule. Returned only if explicitly requested. For more details, see the permissions article.


appIdstringformat GUID

ID of the app that's associated with the schedule. You can't update appId. If you want to create a schedule and ensure its associated events appear in the Bookings calendar, you must provide the Wix Bookings app ID 13d21c63-b5ec-5912-8397-c3a5ddb27a97.


permissionsArray <Permission>maxItems 1

List of permissions associated with the schedule. Refer to the permissions article for more information.

Max: 1 permission


extendedFieldsExtendedFields

Extensions enabling applications or users to save custom data related to the schedule.


revisionintegerRead-onlyformat int64

Revision number, which increments by 1 each time the schedule is updated. To prevent conflicting changes, the current revision must be passed when updating the schedule. Ignored when creating a schedule.


createdDatestringRead-onlyformat date-time

Date the schedule was created in YYYY-MM-DDThh:mm:ss.sssZ format.


updatedDatestringRead-onlyformat date-time

Date the schedule was last updated in YYYY-MM-DDThh:mm:ss.sssZ format.

Did this help?