About Scheduling Form Fields

Scheduling Form Fields is an app created by Wix that lets site collaborators embed appointment booking directly into Wix Forms using an appointment form field component. The app is automatically installed on a site when a collaborator adds a form that includes an appointment field.

How it works

When a site collaborator creates a form with an appointment field, Scheduling Form Fields automatically creates a Bookings service and a booking policy to represent that appointment slot. The service defines the appointment's duration, location, and any linked staff members. The booking policy sets the rules for the appointment, such as cancellation windows and whether manual approval is required. When a site visitor submits the form, Scheduling Form Fields creates and confirms a booking for them, which automatically sets up a related calendar event. Scheduling Form Fields uses the same Calendar API integration as Wix Bookings, you can learn more about how this integration works. The appointment form uses the wix.form_app.form namespace, unlike Wix Meetings which uses wix.meetings.form.

API access by entity

Access levels vary depending on the entity type.

Services and policies

Scheduling Form Fields services and booking policies are read-only through the Wix Bookings APIs. Scheduling Form Fields manages them automatically. You can't create, update, or delete them using the standard Bookings APIs.

Additional characteristics:

• They aren't displayed in the Wix Bookings Service Page or the Wix Bookings dashboard.
• Their appId is set to 6646a75c-2027-4f49-976c-58f3d713ed0f (the Wix Meetings app ID). Scheduling Form Fields runs on the same infrastructure as Wix Meetings, which is why the appId reflects Meetings rather than Scheduling Form Fields itself.
• Their createdByAppId is set to 3e4e322b-6d9b-4da0-9f53-e22c4a44a49e (the Scheduling Form Fields app ID).

Bookings

Scheduling Form Fields bookings have full API access. You can query them using the Bookings Reader V2 API and create, update, and delete them using the Bookings Writer V2 API.

Their appId is set to 6646a75c-2027-4f49-976c-58f3d713ed0f (the Wix Meetings app ID), inherited from the associated service. Their createdByAppId is set to 3e4e322b-6d9b-4da0-9f53-e22c4a44a49e (the Scheduling Form Fields app ID).

Events

Calendar events for Scheduling Form Fields bookings are created and updated automatically when bookings are made or modified. You can also manually update events using the Calendar APIs.

Their appId is set to 6646a75c-2027-4f49-976c-58f3d713ed0f (the Wix Meetings app ID).

Identify Scheduling Form Fields entities in the API

Use createdByAppId to filter Scheduling Form Fields services, booking policies, and bookings:

Manage bookings

Scheduling Form Fields creates and confirms bookings automatically. Common API operations for Scheduling Form Fields bookings include:

• Retrieve bookings made through a form: Call Query Extended Bookings with a createdByAppId filter set to the Scheduling Form Fields app ID. See Identify Scheduling Form Fields entities in the API for the filter syntax.
• Reschedule an appointment: Call Reschedule Booking with the booking ID, the new slot details, and the current booking revision.
• Cancel an appointment: Call Cancel Booking with the booking ID.

Booking solution comparison

The following table summarizes the key differences between booking solutions and their API capabilities:

See also

• Wix Meetings
• Services V2 API
• Booking Policies API
• Bookings Writer V2 API
• Bookings Reader V2 API
• Calendar Events V3 API