> 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/marketing/marketing-plan/calendar-event-v1/introduction.md

## Article Content:

# About the Calendar Events API

The Calendar Events API manages the custom events on a site's marketing calendar. A calendar event is something a site owner wants their marketing to revolve around, such as a sale, holiday, product launch, or business milestone. When the AI generates a marketing plan, it uses these events as context and builds activities around them. The events themselves don't create activities directly.

With the Calendar Events API, you can:

- Create one-time or recurring events.
- Retrieve events within a date range, including read-only events from the site's connected calendars (such as Google Calendar).
- Update and delete site-managed events.

## Before you begin

It's important to note the following points before starting to code:

- Events shape a plan the next time it's generated or regenerated. Adding an event doesn't change an existing plan on its own.
- An event is either one-time, with a single date, or recurring, with a rule that repeats weekly, monthly, or yearly.
- `QueryEvents` also returns read-only events from the site's connected calendars (such as Google Calendar). These events can't be updated or deleted through this API.

## Use cases

- [Plan around a custom calendar event](https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/sample-flows.md#plan-around-a-custom-calendar-event)

## Terminology

- **Calendar event:** A custom event on the marketing calendar, such as a sale or holiday, used as context when generating a plan.
- **Recurring rule:** A rule that makes an event repeat on a weekly, monthly, or yearly schedule.

## See also

- [Marketing Plan API: Sample Flows](https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/sample-flows.md)

@sdk_package_setup