> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Scheduling Form Fields

## Article: About Scheduling Form Fields

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/meetings/scheduling-form-fields.md

## Article Content:

# About Scheduling Form Fields

Scheduling Form Fields is an app created by Wix that lets site collaborators embed appointment booking directly into [Wix Forms](https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/form-object.md) 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction.md) and a [booking policy](https://dev.wix.com/docs/api-reference/business-solutions/bookings/policies/booking-policies/introduction.md) 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/introduction.md) for them, which automatically sets up a related [calendar event](https://dev.wix.com/docs/api-reference/business-management/calendar/events-v3/introduction.md). Scheduling Form Fields uses the same Calendar API integration as Wix Bookings, you can learn more about [how this integration works](https://dev.wix.com/docs/api-reference/business-management/calendar/wix-bookings-integration.md). 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](https://support.wix.com/en/article/wix-bookings-customizing-your-service-pages) 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-reader-v2/introduction.md) and create, update, and delete them using the [Bookings Writer V2 API](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/introduction.md).

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](https://dev.wix.com/docs/api-reference/business-management/calendar/introduction.md).

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:

```json
{
  "filter": {
    "createdByAppId": {
      "$eq": "3e4e322b-6d9b-4da0-9f53-e22c4a44a49e"
    }
  }
}
```

> **Note**: Filtering services or booking policies by `appId` returns all Wix Meetings entities, not only Scheduling Form Fields ones. Use `createdByAppId` when you need to isolate Scheduling Form Fields entities specifically.

## 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](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-reader-v2/query-extended-bookings.md) with a `createdByAppId` filter set to the Scheduling Form Fields app ID. See [Identify Scheduling Form Fields entities in the API](#identify-scheduling-form-fields-entities-in-the-api) for the filter syntax.
- **Reschedule an appointment**: Call [Reschedule Booking](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/reschedule-booking.md) with the booking ID, the new slot details, and the current booking revision.
- **Cancel an appointment**: Call [Cancel Booking](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/cancel-booking.md) with the booking ID.

## Booking solution comparison

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

| Solution | `appId` on services & policies | `createdByAppId` | Services & policies via API | Bookings via API | Wix Bookings dashboard |
|----------|------|------|----|----|-----|
| **Wix Bookings** | `13d21c63-b5ec-5912-8397-c3a5ddb27a97` | `13d21c63-b5ec-5912-8397-c3a5ddb27a97` | Full CRUD | Full CRUD | Shown |
| **Legacy Wix Bookings** | Not set | Not set | Full CRUD | Full CRUD | Shown |
| **Wix Meetings** | `6646a75c-2027-4f49-976c-58f3d713ed0f` | `6646a75c-2027-4f49-976c-58f3d713ed0f` | Full CRUD | Full CRUD | Hidden |
| **Scheduling Form Fields** | `6646a75c-2027-4f49-976c-58f3d713ed0f` | `3e4e322b-6d9b-4da0-9f53-e22c4a44a49e` | Read-only | Full CRUD | Hidden |

## See also

- [Wix Meetings](https://dev.wix.com/docs/api-reference/business-solutions/meetings/introduction.md)
- [Services V2 API](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction.md)
- [Booking Policies API](https://dev.wix.com/docs/api-reference/business-solutions/bookings/policies/booking-policies/introduction.md)
- [Bookings Writer V2 API](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/introduction.md)
- [Bookings Reader V2 API](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-reader-v2/introduction.md)
- [Calendar Events V3 API](https://dev.wix.com/docs/api-reference/business-management/calendar/events-v3/introduction.md)