About the Bookings Calendar APIs

Wix Bookings uses the dedicated Calendar APIs for all scheduling and availability management. Learn more about how Wix Bookings uses the Calendar APIs.

External calendar integration

The External Calendar API allows you to sync Wix Bookings with external calendar providers such as Google, Microsoft, and Apple. It supports bidirectional synchronization, letting businesses import events from external calendars and export Wix Bookings events to them.

Deprecated Bookings calendar APIs

Important:

Wix has deprecated all Calendar-related APIs under Bookings, except for the External Calendar API. Use the stand-alone Calendar APIs instead.

Migrate from deprecated Bookings calendar APIs

To migrate from deprecated Bookings Calendar APIs to the new Calendar V3 APIs:

  1. Update API methods: Replace all Bookings calendar methods with corresponding Calendar API methods.
  2. App ID filtering: Implement app ID filtering using 13d21c63-b5ec-5912-8397-c3a5ddb27a97 for all Bookings-related schedules.
  3. Business schedule access: Use the fixed "externalId": "4e0579a5-491e-4e70-a872-d097eed6e520" when managing the business schedule.
  4. Event retrieval: To retrieve events for a specific schedule, call Query Events with a query filter specifying the relevant schedule ID in query.filter.
  5. External calendar integration: No changes needed. Continue using the External Calendar API for external calendar connections. This API remains active and isn't affected by the migration.
Did this help?