Schedule Object

Attributes
idstring
Schedule ID.

scheduleOwnerIdstring
ID of the schedule's owner entity. This may be a resource ID or a service ID.

timeZonestringRead-only
Schedule's time zone in Area/Location format. Read-only. Derived from the Wix Business time zone.

intervalsArray <RecurringInterval>deprecated
Deprecated. Please use the Sessions API instead.

titlestringmaxLength 6000
Default title for the schedule's sessions. Maximum length: 6000 characters.

tagsstringdeprecated
Deprecated. Tags for grouping schedules. These tags are the default tags for the schedule's sessions. The Wix Bookings app uses the following predefined tags to set schedule type: "INDIVIDUAL", "GROUP", and "COURSE". Once the schedule type is set using these tags, you cannot update it. In addition to the app's tags, you can create and update your own tags.

locationobject
Default location for the schedule's sessions.

capacityintegerminimum 1maximum 1000format int32
Maximum number of participants that can be added to the schedule's sessions. Must be at most 1 for schedule whose availability is affected by another schedule. E.g, appointment schedules of the Wix Bookings app.

rateobjectdeprecated
Deprecated. Please use the Booking Services V2 payment instead.

availabilityobjectdeprecated
Deprecated.

totalNumberOfParticipantsintegerRead-only
Number of participants registered to sessions in this schedule, calculated as the sum of the party sizes.

participantsArray <Participant>Read-only
Partial list* of participants which are registered to sessions in this schedule. Participants who are registered in the schedule are automatically registered to any session that is created for the schedule. To retrieve the full list of schedule participants please use the Query Extended Bookings API.

externalCalendarOverridesobjectdeprecated
Deprecated.

statusstringRead-only
3 enum supported values:
UNDEFINEDCREATEDCANCELLED
Schedule status.

createdstringRead-onlyformat date-time
Schedule creation date.

updatedstringRead-onlyformat date-time
Schedule last update date.

versionintegerRead-only
Schedule version number, updated each time the schedule is updated.

inheritedFieldsArray <string>Read-only
Fields which were inherited from the Business Info page under Settings in the Dashboard.

conferenceProviderobjectdeprecated
Deprecated.

calendarConferenceobjectdeprecated
A conference created for the schedule. This is used when a participant is added to a schedule. Partially deprecated. Only hostUrl and guestUrl are to be supported.
Was this helpful?
Yes
No

GetList Schedules

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Lists schedules by schedule IDs or schedule owner IDs.

Permissions This endpoint requires the Read Bookings Calendar or the Manage Bookings permission scope. With the Read Bookings Calendar permission scope, the schedule participants are not returned.

Endpoint
GET
https://www.wixapis.com/bookings/v1/calendar/schedules

Was this helpful?
Yes
No

PostCreate Schedule

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a schedule

Permissions This endpoint requires the Manage Bookings permissions scope

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/schedules

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

PatchUpdate Schedule

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Updates a schedule. This method supports patch semantics. The field values you specify replace the existing values. Fields that you don’t specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays, and therefore discards any previous array elements. The availability.locations array cannot be updated. Please use the setAvailabilityLocations endpoint instead.

Permissions This endpoint requires the Manage Bookings permissions scope

Endpoint
PATCH
https://www.wixapis.com/bookings/v1/calendar/schedules/{schedule.id}

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

PostCancel Schedule

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Cancels a schedule. Equivalent to batch cancel of sessions linked to a single schedule. The schedule changes to status = CANCELED - all sessions up until the time of cancellation are kept, and all future sessions are removed.

Permissions This endpoint requires the Manage Bookings permissions scope

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/schedules/{scheduleId}/cancel

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

GetGet Schedule

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

ets a schedule from the calendar.

Permissions This endpoint requires the Read Bookings Calendar or the Manage Bookings permissions scope. With the Read Bookings Calendar permission scope, the schedule participants are not returned.

Endpoint
GET
https://www.wixapis.com/bookings/v1/calendar/schedules/{id}

Was this helpful?
Yes
No

PostCreate Session

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/sessions

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

PatchUpdate Session

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Updates a session.

The property values specified replace the existing values. If a property is not specified in the request it will remain unchanged. Array properties, if specified, overwrite the existing array and all of its elements. The participants array cannot be updated. Use the participantNotification property to send an email to the participants notifying them of the change.

Permissions This endpoint requires the Manage Bookings permissions scope

Endpoint
PATCH
https://www.wixapis.com/bookings/v1/calendar/sessions/{session.id}

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

PostDelete Session

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Deletes a session from a schedule.

Use the participantNotification property to send an email to the participants when the session is deleted.

When deleting a session of type "EVENT" where a booking exists, the booking's status is updated to "CANCELED".

To delete a set of recurring sessions, specify the session's recurringSessionId in the sessionId property of the request parameters.

Permissions This endpoint requires the Manage Bookings permissions scope

@snippet [deleteSession.es6=Delete a session.]

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/sessions/{id}/cancel

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No

GetGet Session

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Returns a session from the calendar.

Permissions This endpoint requires the Read Bookings Calendar or the Manage Bookings permission scope. With the Read Bookings Calendar permission scope, the session participants are not returned.

Endpoint
GET
https://www.wixapis.com/bookings/v1/calendar/sessions/{id}

Was this helpful?
Yes
No

PostList Sessions

Deprecated

This method has been deprecated, and will be replaced in the future.

Returns multiple sessions from the calendar.

Permissions This endpoint requires the Read Bookings Calendar or the Manage Bookings permission scope With the Read Bookings Calendar permission scope, the sessions return without participants.

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/sessions/list

Was this helpful?
Yes
No

Schedule Notification

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Permission Scopes

For app development, you must have one of the following permission scopes:
Manage Bookings
Read Bookings - Including Participants
Read Bookings - all read permissions
Manage Bookings - all permissions
Read bookings calendar - including participants
Learn more about permission scopes.
Event BodyEvent Body Event data is received as a JSON Web Token (JWT). It may be delayed. Be sure to verify the data was sent by Wix.
Event Data
preserveFutureSessionsWithParticipantsboolean

notifyParticipantsbooleandeprecated
Whether to notify participants about changed sessions. deprecated, use participant_notification

sitePropertiesobject
site properties. Optional. Given in create schedule notification.

instanceIdstring

ONE OF:


scheduleCreatedobject

scheduleUpdatedobject

scheduleCancelledobject

sessionCreatedobject

sessionUpdatedobject

sessionCancelledobject

availabilityPolicyUpdatedobject

intervalSplitobjectdeprecated

recurringSessionSplitobject

scheduleUnassignedFromUserobjectdeprecated
Inspect schedule.scheduleOwnerUserId on scheduleUpdated instead.
Was this helpful?
Yes
No