> 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: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/calendar/introduction.md

## Article Content:

# About the Calendar APIs

The Calendar APIs allow you to view and manage business
schedules and events. You can use it to build a custom scheduling solution
that supports recurring events, varying time zones, linked resources,
participation management, and customized permissions. You can also extend and
customize Wix Business Solutions that use a calendar, such as Wix Bookings.

## Key concepts

Before diving into the Calendar APIs, it's helpful to familiarize yourself with
a few essential terms. The API is structured around **schedules**, which group
together related **events** like classes or meetings. Each schedule defines a **time frame**
based on the start and end dates of its events. You can use **event views**
to track updates and changes in the schedule over time. Additionally, the
**participation** object captures details about individuals attending an event,
including their confirmation status and any custom data you need to store.

With the Calendar APIs, you can:

+ Manage [schedules](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction.md).
+ Retrieve [schedule time frames](https://dev.wix.com/docs/rest/business-management/calendar/schedule-time-frames-v3/introduction.md).
+ Manage [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md).
+ Retrieve [event views](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction.md).
+ Manage [participation details](https://dev.wix.com/docs/rest/business-management/calendar/participations-v3/introduction.md).

## Before you begin

It’s important to note the following points before you start coding:

+ The schedule object itself doesn’t store event details. Each event is independently managed.
+ An event must belong to exactly one schedule.
+ Once a schedule is marked as `CANCELLED`, you can't reactivate, update, or associate it with new events.
+ Recurring events aren't defined by the schedule itself. Instead, create a `MASTER` event to establish the recurrence pattern.

## Use cases

+ [Manage a calendar](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#manage-a-calendar).
+ [Sync calendars to an external system](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#sync-calendars-to-an-external-system).
+ [Create a participant dashboard](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#create-a-participant-dashboard).
+ [Block Wix Bookings resources](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#block-wix-bookings-resources).

## Terminology

+ __[Event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md)__: A calendar entry with details like timing, location, and participants. Each event is associated with exactly 1 schedule, from which it may inherit [default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values.md). Events can either be standalone, part of a recurring series, or define a recurrence pattern. You can also specify whether events block time on the schedule or allow other events to be scheduled concurrently.
+ __[Schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction.md)__: Collection of events associated with a specific entity, such as a [Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object.md), or [Bookings resource](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/resource-object.md). Schedules set default values for the events they manage, like a location.
+ __[Schedule time frame](https://dev.wix.com/docs/rest/business-management/calendar/schedule-time-frames-v3/introduction.md)__: Information about the start and end dates of the first and last events that belong to a schedule and whether any events follow an unlimited repetition pattern.
+ __[Event view](https://dev.wix.com/docs/rest/business-management/calendar/event-views-v3/introduction.md)__: Subscribing to the event view lets you keep track of a calendar's single-occurrence, `EXCEPTION`, and `INSTANCE` events at least one year into the future.
+ __[Participation](https://dev.wix.com/docs/rest/business-management/calendar/participations-v3/introduction.md)__: Representation of the relationship between a participant and an event or schedule. It includes details about the participant, whether the participation status is confirmed or pending, which app owns the relevant event or schedule, and allows for custom data extensions.

## See also

+ [Wix Bookings APIs](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings.md)
  + [Services V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction.md)
  + [Resources API](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/resource-v2/introduction.md)
  + [Staff Members API](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members-and-resources/staff-member-v1/introduction.md)