# Calendar API API

> Calendar API API on Apizie: 38 endpoints (Returns an access control rule., Updates an access control rule., Updates an access control rule. This method supports patch semantics., Deletes an access control rule., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/analytics:googleapis-calendar/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-calendar`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/workspace/calendar/firstapp
- Page: https://zieapi.vercel.app/api/analytics/googleapis-calendar
- OpenAPI: https://zieapi.vercel.app/api/analytics/googleapis-calendar/openapi.json

Manipulates events and other calendar data.

## Endpoints

### Returns an access control rule.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| ruleId | string | yes | ACL rule identifier. |

### Updates an access control rule.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| ruleId | string | yes | ACL rule identifier. |
| sendNotifications | boolean | no | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The… |
| body | object | yes | JSON request body |

### Updates an access control rule. This method supports patch semantics.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| ruleId | string | yes | ACL rule identifier. |
| sendNotifications | boolean | no | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The… |
| body | object | yes | JSON request body |

### Deletes an access control rule.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| ruleId | string | yes | ACL rule identifier. |

### Returns the rules in the access control list for the calendar.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| showDeleted | boolean | no | Whether to include deleted ACLs in the result. Deleted ACLs are represented by role equal to "none". Deleted ACLs will always be included… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |

### Creates an access control rule.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| sendNotifications | boolean | no | Whether to send notifications about the calendar sharing change. Optional. The default is True. |
| body | object | yes | JSON request body |

### Watch for changes to ACL resources.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-watch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| showDeleted | boolean | no | Whether to include deleted ACLs in the result. Deleted ACLs are represented by role equal to "none". Deleted ACLs will always be included… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |
| body | object | yes | JSON request body |

### Returns a calendar from the user's calendar list.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |

### Updates an existing calendar on the user's calendar list.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| colorRgbFormat | boolean | no | Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based… |
| body | object | yes | JSON request body |

### Updates an existing calendar on the user's calendar list. This method supports patch semantics.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| colorRgbFormat | boolean | no | Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based… |
| body | object | yes | JSON request body |

### Removes a calendar from the user's calendar list.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |

### Returns the calendars on the user's calendar list.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| minAccessRole | string | no | The minimum access role for the user in the returned entries. Optional. The default is no restriction. |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| showDeleted | boolean | no | Whether to include deleted calendar list entries in the result. Optional. The default is False. |
| showHidden | boolean | no | Whether to show hidden entries. Optional. The default is False. |
| showOwnOrganizationOnly | boolean | no | Whether to show only entries for calendars from the organization. This parameter is only applicable to Google Workspace users. Optional.… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |

### Inserts an existing calendar into the user's calendar list.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| colorRgbFormat | boolean | no | Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based… |
| body | object | yes | JSON request body |

### Watch for changes to CalendarList resources.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendar-list-watch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| minAccessRole | string | no | The minimum access role for the user in the returned entries. Optional. The default is no restriction. |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| showDeleted | boolean | no | Whether to include deleted calendar list entries in the result. Optional. The default is False. |
| showHidden | boolean | no | Whether to show hidden entries. Optional. The default is False. |
| showOwnOrganizationOnly | boolean | no | Whether to show only entries for calendars from the organization. This parameter is only applicable to Google Workspace users. Optional.… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |
| body | object | yes | JSON request body |

### Clears a primary calendar. This operation deletes all events associated with the primary calendar of an…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-clear` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |

### Returns metadata for a calendar.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |

### Updates metadata for a calendar.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| body | object | yes | JSON request body |

### Updates metadata for a calendar. This method supports patch semantics.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| body | object | yes | JSON request body |

### Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |

### Creates a secondary calendar. The authenticated user for the request is made the data owner of the new…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Transfers a secondary calendar between users within a Google Workspace organization. Requires user…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-calendars-transfer-ownership` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs, call the calendarList.list method. |
| newDataOwner | string | yes | The email address of a user who will become the data owner of the calendar. |
| useAdminAccess | boolean | yes | When true, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace… |

### Stop watching resources through this channel
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-channels-stop` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Returns the color definitions for calendars and events.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-colors-get` (byok)

### Returns an event based on its Google Calendar ID. To retrieve an event using its iCalendar ID, call the…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email… |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| eventId | string | yes | Event identifier. |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| timeZone | string | no | Time zone used in the response. Optional. The default is the time zone of the calendar. |

### Updates an event.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email… |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| conferenceDataVersion | integer | no | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in… |
| eventId | string | yes | Event identifier. |
| eventLabelVersion | integer | no | Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId… |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the event update (for example, description changes, etc.).… |
| sendUpdates | string | no | Guests who should receive notifications about the event update (for example, title changes, etc.). |
| supportsAttachments | boolean | no | Whether API client performing operation supports event attachments. Optional. The default is False. |
| body | object | yes | JSON request body |

### Updates an event. This method supports patch semantics.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email… |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| conferenceDataVersion | integer | no | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in… |
| eventId | string | yes | Event identifier. |
| eventLabelVersion | integer | no | Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId… |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the event update (for example, description changes, etc.).… |
| sendUpdates | string | no | Guests who should receive notifications about the event update (for example, title changes, etc.). |
| supportsAttachments | boolean | no | Whether API client performing operation supports event attachments. Optional. The default is False. |
| body | object | yes | JSON request body |

### Deletes an event.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| eventId | string | yes | Event identifier. |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the deletion of the event. Note that some emails might… |
| sendUpdates | string | no | Guests who should receive notifications about the deletion of the event. |

### Imports an event. This operation is used to add a private copy of an existing event to a calendar. Only…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-import` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| conferenceDataVersion | integer | no | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in… |
| eventLabelVersion | integer | no | Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId… |
| supportsAttachments | boolean | no | Whether API client performing operation supports event attachments. Optional. The default is False. |
| body | object | yes | JSON request body |

### Returns events on the specified calendar.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| eventTypes | string | no | Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all… |
| iCalUID | string | no | Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its… |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| maxResults | integer | no | Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at… |
| orderBy | string | no | The order of the events returned in the result. Optional. The default is an unspecified, stable order. |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| privateExtendedProperty | string | no | Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple… |
| q | string | no | Free text search terms to find events that match these terms in the following fields: - summary - description - location - attendee's… |
| sharedExtendedProperty | string | no | Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple… |
| showDeleted | boolean | no | Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events (but not the… |
| showHiddenInvitations | boolean | no | Whether to include hidden invitations in the result. Optional. The default is False. |
| singleEvents | boolean | no | Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |
| timeMax | string | no | Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339… |
| timeMin | string | no | Lower bound (exclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339… |
| timeZone | string | no | Time zone used in the response. Optional. The default is the time zone of the calendar. |
| updatedMin | string | no | Lower bound for an event's last modification time (as a RFC3339 timestamp) to filter by. When specified, entries deleted since this time… |

### Creates an event.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| conferenceDataVersion | integer | no | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in… |
| eventLabelVersion | integer | no | Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId… |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the creation of the new event. Note that some emails might… |
| sendUpdates | string | no | Whether to send notifications about the creation of the new event. Note that some emails might still be sent. The default is false. |
| supportsAttachments | boolean | no | Whether API client performing operation supports event attachments. Optional. The default is False. |
| body | object | yes | JSON request body |

### Returns instances of the specified recurring event.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email… |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| eventId | string | yes | Recurring event identifier. |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| maxResults | integer | no | Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500… |
| originalStart | string | no | The original start time of the instance in the result. Optional. |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| showDeleted | boolean | no | Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events will still be… |
| timeMax | string | no | Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339… |
| timeMin | string | no | Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339… |
| timeZone | string | no | Time zone used in the response. Optional. The default is the time zone of the calendar. |

### Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-move` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier of the source calendar where the event currently is on. |
| destination | string | yes | Calendar identifier of the target calendar where the event is to be moved to. |
| eventId | string | yes | Event identifier. |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the change of the event's organizer. Note that some emails… |
| sendUpdates | string | no | Guests who should receive notifications about the change of the event's organizer. |

### Creates an event based on a simple text string.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-quick-add` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| sendNotifications | boolean | no | Deprecated. Please use sendUpdates instead. Whether to send notifications about the creation of the event. Note that some emails might… |
| sendUpdates | string | no | Guests who should receive notifications about the creation of the new event. |
| text | string | yes | The text describing the event to be created. |

### Watch for changes to Events resources.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-events-watch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| alwaysIncludeEmail | boolean | no | Deprecated and ignored. |
| calendarId | string | yes | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the… |
| eventTypes | string | no | Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all… |
| iCalUID | string | no | Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its… |
| maxAttendees | integer | no | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant… |
| maxResults | integer | no | Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at… |
| orderBy | string | no | The order of the events returned in the result. Optional. The default is an unspecified, stable order. |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| privateExtendedProperty | string | no | Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple… |
| q | string | no | Free text search terms to find events that match these terms in the following fields: - summary - description - location - attendee's… |
| sharedExtendedProperty | string | no | Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple… |
| showDeleted | boolean | no | Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events (but not the… |
| showHiddenInvitations | boolean | no | Whether to include hidden invitations in the result. Optional. The default is False. |
| singleEvents | boolean | no | Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the… |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |
| timeMax | string | no | Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339… |
| timeMin | string | no | Lower bound (exclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339… |
| timeZone | string | no | Time zone used in the response. Optional. The default is the time zone of the calendar. |
| updatedMin | string | no | Lower bound for an event's last modification time (as a RFC3339 timestamp) to filter by. When specified, entries deleted since this time… |
| body | object | yes | JSON request body |

### Returns free/busy information for a set of calendars.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-freebusy-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Returns a single user setting.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-settings-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| setting | string | yes | The id of the user setting. |

### Returns all user settings for the authenticated user.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-settings-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |

### Watch for changes to Settings resources.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-settings-watch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | no | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250… |
| pageToken | string | no | Token specifying which result page to return. Optional. |
| syncToken | string | no | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of… |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Calendar API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/analytics:googleapis-calendar/calendar-acl-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Calendar API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Calendar API itself also needs your own key from googleapis.com.

### Can AI agents use the Calendar API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-calendar.

### What is the status of the Calendar API API?
Needs your own provider key (bring your own key)