Booking Policy Object

A booking policy is a set of rules that determine how customers can book a service, including timeframes for booking, canceling, or rescheduling.

Properties
appIdstringformat GUIDimmutable

ID of the app associated with the booking policy. You can't update appId. Booking policies are displayed in Wix Bookings only if they are associated with the Wix Bookings app ID or have no associated app ID. Default: 13d21c63-b5ec-5912-8397-c3a5ddb27a97 (Wix Bookings app ID) For booking policies from Wix apps, the following values apply:

  • Wix Bookings: "13d21c63-b5ec-5912-8397-c3a5ddb27a97"
  • Wix Services: "cc552162-24a4-45e0-9695-230c4931ef40"
  • Wix Meetings: "6646a75c-2027-4f49-976c-58f3d713ed0f" Full list of apps created by Wix.
bookAfterStartPolicyBookAfterStartPolicy

Rule for booking after the start of a session or course. This rule and limitLateBookingPolicy can't be both enabled at the same time.

cancellationFeePolicyCancellationFeePolicy

Rules for cancellation fees.

cancellationPolicyCancellationPolicy

Rule for canceling a booking.

createdByAppIdstringRead-onlyformat GUID

ID of the app that created the booking policy. This field is used for analytics, auditing, and tracking creation sources. This read-only field is automatically populated during policy creation by checking these sources in order:

  1. The caller's App ID from the request identity context.
  2. The policy's appId field.
  3. The Wix Bookings App ID (13d21c63-b5ec-5912-8397-c3a5ddb27a97) as the final fallback.
_createdDateDateRead-only

Date and time the booking policy was created in YYYY-MM-DDThh:mm:ss.sssZ format.

customPolicyDescriptionPolicyDescription

Custom description for the booking policy and whether it's displayed to the participant.

defaultbooleanRead-only

Whether the booking policy is the default.

extendedFieldsExtendedFields

Extensions enabling users to save custom data related to the booking policies.

_idstringRead-onlyformat GUID

ID of the booking policy.

limitEarlyBookingPolicyLimitEarlyBookingPolicy

Rule for limiting early bookings.

limitLateBookingPolicyLimitLateBookingPolicy

Rule for limiting late bookings. This rule and bookAfterStartPolicy can't be both enabled at the same time.

namestringmaxLength 400

Name of the booking policy.

participantsPolicyParticipantsPolicy

Rule for participants per booking.

reschedulePolicyReschedulePolicy

Rule for rescheduling a booking.

revisionstringRead-onlyformat int64

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

saveCreditCardPolicySaveCreditCardPolicy

Rule for saving credit card details.

_updatedDateDateRead-only

Date and time the booking policy was updated in YYYY-MM-DDThh:mm:ss.sssZ format.

waitlistPolicyWaitlistPolicy

Waitlist rule for the service.

Did this help?