---
canonical_url: "https://docs.composio.dev/toolkits/zoho_calendar"
markdown_url: "https://docs.composio.dev/toolkits/zoho_calendar.md"
product: "platform"
version: null
last_updated: null
---

# Zoho Calendar

Zoho Calendar manages calendars, events, availability, settings, and organizational resource bookings across Zoho data centers.

- **Category:** calendar
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 57
- **Triggers:** 0
- **Slug:** `ZOHO_CALENDAR`
- **Version:** 00000000_00

## Tools

### Check Resource Booking Access

**Slug:** `ZOHO_CALENDAR_CHECK_RESOURCE_BOOKING_ACCESS`

Check whether Resource Booking is enabled for the connected Zoho account. Resource Booking requires a paid Zoho plan; use this as an entitlement preflight, not as a general credential test.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Booking

**Slug:** `ZOHO_CALENDAR_CREATE_BOOKING`

Book one or more available rooms in paid Zoho Resource Booking, optionally with attendees, groups, notifications, or a daily, weekly, or monthly recurrence. Notification modes 1 and 2 immediately send attendee notifications that cannot be recalled. The booking must stay within administrator-configured limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `booking_data` | object | Yes | Strict paid room-booking payload serialized once as Zoho bookingData. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Booking Branch

**Slug:** `ZOHO_CALENDAR_CREATE_BRANCH`

Create a branch with buildings and floors in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `branch_data` | object | Yes | Strict branch definition, including its buildings and floors. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Calendar

**Slug:** `ZOHO_CALENDAR_CREATE_CALENDAR`

Create a personal calendar with a required name and color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calendar_data` | object | Yes | Strict calendar creation settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Event

**Slug:** `ZOHO_CALENDAR_CREATE_EVENT`

Create a timed, all-day, or recurring Zoho Calendar event without creating Zoho Meeting conferencing. Notification modes 1 and 2 immediately send attendee or attendee-and-organizer notifications that cannot be recalled. To attach a file, first call UPLOAD_EVENT_ATTACHMENT, then pass its returned ID in event_data.attach.file_ids.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_data` | object | Yes | Strict timed, all-day, or recurring event payload without Zoho Meeting creation. |
| `calendar_id` | string | Yes | Opaque UID of the destination calendar. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Booking Room

**Slug:** `ZOHO_CALENDAR_CREATE_RESOURCE`

Create a room in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission. Room image upload is not exposed because Zoho does not document the photo transport encoding; its paired image file name is therefore not settable either.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_data` | object | Yes | Strict definition of the room resource to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Booking Organization Settings

**Slug:** `ZOHO_CALENDAR_CREATE_RESOURCE_BOOKING_ORG_SETTINGS`

Initialize organization-wide limits in paid Zoho Resource Booking. The connected user must be an organization administrator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `settings_data` | object | Yes | Non-empty organization-wide Resource Booking duration settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Booking User Settings

**Slug:** `ZOHO_CALENDAR_CREATE_RESOURCE_BOOKING_USER_SETTINGS`

Initialize user preferences in paid Zoho Resource Booking. By default this targets the connected user; supplying another user's user_id requires organization administrator access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | Opaque Zoho user ID to configure. Omit it for the connected user; targeting another user requires organization administrator access. |
| `settings_data` | object | Yes | Non-empty Resource Booking user preferences. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Resource Feature

**Slug:** `ZOHO_CALENDAR_CREATE_RESOURCE_FEATURE`

Create a feature definition in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feature_data` | object | Yes | Strict feature definition to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Resource Booking

**Slug:** `ZOHO_CALENDAR_DELETE_BOOKING`

Permanently delete one room booking, all or future recurrence occurrences, or one selected occurrence. This destructive action requires a paid Zoho plan with Resource Booking enabled and can optionally notify attendees.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `booking_id` | string | Yes | Opaque booking ID to permanently delete from paid Zoho Resource Booking. Pass the ID exactly as returned by Zoho. |
| `notify_attendees` | integer | No | Attendee notification mode: 0 notifies nobody, 1 notifies everyone except you, and 2 notifies everyone including you. |
| `recurrence_id_millis` | string | No | Exact decimal recurrence occurrence ID in milliseconds returned by Zoho; requires recurrence_delete_type. |
| `recurrence_delete_type` | string ("all" | "following" | "only") | No | Recurrence deletion scope: all occurrences, this and following occurrences, or only the selected occurrence; requires recurrence_id_millis. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Resource Booking Branch

**Slug:** `ZOHO_CALENDAR_DELETE_BRANCH`

Permanently delete a branch from paid Zoho Resource Booking. This destructive operation requires Resource Booking administration permission. Zoho rejects the deletion with BRANCH_TAG_WITH_ROOMS while rooms remain attached; remove or move those rooms before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `branch_id` | string | Yes | Opaque Zoho Resource Booking branch ID to delete. Pass the ID exactly as returned by Zoho; do not URL-encode it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Calendar

**Slug:** `ZOHO_CALENDAR_DELETE_CALENDAR`

Permanently delete a calendar and return Zoho's deletion envelope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calendar_id` | string | Yes | Opaque UID of the calendar to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Event

**Slug:** `ZOHO_CALENDAR_DELETE_EVENT`

Delete an event, all following recurrences, or one recurrence instance using the latest ETag. Optional notification modes 1 and 2 immediately send deletion or cancellation notifications that cannot be recalled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Latest numeric event ETag returned by Zoho Calendar. |
| `event_id` | string | Yes | Opaque UID of the event to delete. |
| `calendar_id` | string | Yes | Opaque UID of the calendar containing the event. |
| `recurrence_id` | string | No | Recurrence instance ID, exactly yyyyMMdd'T'HHmmss'Z' in GMT or yyyyMMdd for an all-day event. Without recurrence_edit_type, Zoho deletes only this occurrence. |
| `notify_attendees` | integer ("0" | "1" | "2") | No | Attendee notification mode: 0 none, 1 attendees only, or 2 attendees and organizer. |
| `recurrence_edit_type` | string ("following" | "only") | No | Explicitly delete this and following occurrences or only this occurrence; requires recurrence_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Event Attachments

**Slug:** `ZOHO_CALENDAR_DELETE_EVENT_ATTACHMENTS`

Remove specified attachments from an event using its full date/time data and latest ETag; the event itself remains.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Latest opaque event ETag. |
| `event_id` | string | Yes | Opaque event UID. |
| `calendar_id` | string | Yes | Opaque calendar UID. |
| `date_and_time` | object | Yes | Current event start and end data in exact timed or all-day format. |
| `attachment_ids` | array | Yes | One or more non-empty opaque attachment IDs to remove. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Resource

**Slug:** `ZOHO_CALENDAR_DELETE_RESOURCE`

Permanently delete a room resource from paid Zoho Resource Booking. This destructive, admin-only operation also permanently deletes every booking associated with the resource.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | Opaque Zoho Resource Booking resource ID to permanently delete, along with every booking associated with that resource. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Resource Feature

**Slug:** `ZOHO_CALENDAR_DELETE_RESOURCE_FEATURE`

Permanently delete a feature from paid Zoho Resource Booking. This destructive operation requires Resource Booking administration permission. Zoho rejects the deletion with FEATURE_TAG_WITH_ROOMS while any room uses the feature; remove the feature from those rooms before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feature_id` | string | Yes | Opaque Zoho Resource Booking feature ID to delete. Pass the ID exactly as returned by Zoho. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Event Attachment

**Slug:** `ZOHO_CALENDAR_DOWNLOAD_EVENT_ATTACHMENT`

Download one event attachment. Zoho may redirect view mode before returning the file, and PNG files download in either mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | Opaque attachment file ID. |
| `api_mode` | string ("view" | "download") | No | Ask Zoho to view or download the attachment. PNG files download in either mode. |
| `event_id` | string | Yes | Opaque event UID containing the attachment. |
| `calendar_id` | string | Yes | Opaque calendar UID containing the event. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Resource Image

**Slug:** `ZOHO_CALENDAR_DOWNLOAD_RESOURCE_IMAGE`

Download one resource image by its opaque image ID, exact provider file name, and owning resource ID. Requires a paid Zoho Resource Booking plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_id` | string | Yes | Opaque Resource Booking image ID. |
| `file_name` | string | Yes | Exact provider file name for the resource image. |
| `resource_id` | string | Yes | Opaque Resource Booking resource ID that owns the image. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Favorite Resource

**Slug:** `ZOHO_CALENDAR_FAVORITE_RESOURCE`

Mark one room as a favorite for the connected user. This action requires a paid Zoho plan with Resource Booking enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | Opaque ID of the paid Resource Booking room to mark as a favorite. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Booking

**Slug:** `ZOHO_CALENDAR_GET_BOOKING`

Return one room booking or a specified recurrence occurrence from paid Zoho Resource Booking. The connected account must have Resource Booking enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `booking_id` | string | Yes | Opaque Zoho Resource Booking booking ID. |
| `recurrence_id` | string | No | Specific recurrence occurrence as Zoho's decimal long millisecond ID, returned by the booking-list API. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Booking Branch

**Slug:** `ZOHO_CALENDAR_GET_BRANCH`

Return one Resource Booking branch with its buildings and floors. This endpoint requires a paid Zoho plan with Resource Booking enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `branch_id` | string | Yes | Opaque Zoho branch ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calendar

**Slug:** `ZOHO_CALENDAR_GET_CALENDAR`

Return full details for one calendar UID, including the documented default or primary aliases.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calendar_id` | string | Yes | Opaque calendar UID, or the documented value 'default' or 'primary'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calendar Settings

**Slug:** `ZOHO_CALENDAR_GET_CALENDAR_SETTINGS`

Return the connected user's Calendar preferences.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event

**Slug:** `ZOHO_CALENDAR_GET_EVENT`

Return full details for one event or a specified recurrence instance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Opaque event UID. |
| `calendar_id` | string | Yes | Opaque calendar UID. |
| `recurrence_id` | string | No | Specific recurrence instance, exactly yyyyMMdd'T'HHmmss'Z' for a timed event or yyyyMMdd for an all-day event. Required for a broken-out instance. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Booking Resource

**Slug:** `ZOHO_CALENDAR_GET_RESOURCE`

Return one room from paid Zoho Resource Booking. Resource Booking must be enabled for the connected account. include_current_time strictly selects Zoho's bare resource or resource/current_time response variant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | Opaque Zoho Resource Booking resource ID. |
| `include_current_time` | boolean | Yes | Whether to return the resource wrapped with Zoho's current_time. False returns the bare resource object. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Booking Organization Settings

**Slug:** `ZOHO_CALENDAR_GET_RESOURCE_BOOKING_ORG_SETTINGS`

Return organization-wide policy settings from paid Zoho Resource Booking. The connected account must have Resource Booking enabled and organization administrator access.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Booking User Settings

**Slug:** `ZOHO_CALENDAR_GET_RESOURCE_BOOKING_USER_SETTINGS`

Return user preferences from paid Zoho Resource Booking. Omit user_id for the connected user's settings; querying another user requires organization administrator access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | Opaque Zoho user ID whose Resource Booking settings to return. Omit this for the connected user; querying another user requires organization administrator access. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Feature

**Slug:** `ZOHO_CALENDAR_GET_RESOURCE_FEATURE`

Return one feature definition from paid Zoho Resource Booking. The connected account must have Resource Booking enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feature_id` | string | Yes | Opaque Zoho Resource Booking feature ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Resource Free Busy

**Slug:** `ZOHO_CALENDAR_GET_RESOURCE_FREE_BUSY`

Return strict date-keyed busy intervals for one room resource over an exact inclusive date range. This unpaginated endpoint requires a paid Zoho plan with Resource Booking enabled, and the range cannot exceed the booking duration configured by an administrator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date exactly MM/dd/yyyy, not before start_date and within the administrator-configured booking duration. |
| `timezone` | string | No | Optional IANA timezone of the resource's branch. |
| `start_date` | string | Yes | Inclusive start date exactly MM/dd/yyyy. |
| `resource_auto_name` | string | Yes | Opaque resource auto_gen_name used by Zoho's path, not the numeric resource ID returned as a response key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Free Busy

**Slug:** `ZOHO_CALENDAR_GET_USER_FREE_BUSY`

Return event-based or time-based free/busy data for one email and exact local-naive time range. This endpoint is not paginated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("eventbased" | "timebased") | No | Return either Zoho's event-based envelope or its date-keyed time-based object. |
| `user_email` | string | Yes | User email whose availability to query. |
| `end_datetime` | string | Yes | End exactly yyyyMMdd'T'HHmmss without a Z or timezone offset and lexically later than start_datetime. |
| `start_datetime` | string | Yes | Start exactly yyyyMMdd'T'HHmmss without a Z or timezone offset. Zoho interprets this lexical local value. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resource Bookings

**Slug:** `ZOHO_CALENDAR_LIST_BOOKINGS`

Return bookings for selected rooms in a paid Zoho Resource Booking branch. This endpoint is not paginated and requires an inclusive MM/DD/YYYY start and end date, matching Zoho's official request example.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date exactly MM/DD/YYYY and not before start_date. |
| `timezone` | string | No | Optional IANA timezone for the Resource Booking branch. |
| `branch_id` | string | Yes | Opaque branch ID whose selected room bookings should be returned. |
| `start_date` | string | Yes | Inclusive start date exactly MM/DD/YYYY. |
| `resource_ids` | array | Yes | One or more opaque resource IDs. The action serializes this typed array once as the single compact JSON query value resources. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resource Booking Branches

**Slug:** `ZOHO_CALENDAR_LIST_BRANCHES`

Return all branches from paid Zoho Resource Booking, including their buildings and floors. Resource Booking must be enabled for the connected account. Zoho documents this endpoint as an unpaginated bare list.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Calendars

**Slug:** `ZOHO_CALENDAR_LIST_CALENDARS`

Return calendars visible to the connected user, optionally by documented category and hidden status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category` | string ("own" | "group" | "app" | "others" | "all") | No | Calendar ownership category to return. |
| `show_hidden_calendars` | boolean | No | Whether to include hidden calendars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Calendar Shares

**Slug:** `ZOHO_CALENDAR_LIST_CALENDAR_SHARES`

Return user and group sharing entries for one calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calendar_id` | string | Yes | Opaque calendar UID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Instances

**Slug:** `ZOHO_CALENDAR_LIST_EVENT_INSTANCES`

Return recurrence instances for one repeating event in a required range of at most 90 days. This endpoint is not paginated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `range` | object | Yes | Matching timed or all-day start and end values spanning at most 90 days. |
| `event_id` | string | Yes | Opaque UID of a repeating event. |
| `calendar_id` | string | Yes | Opaque calendar UID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events

**Slug:** `ZOHO_CALENDAR_LIST_EVENTS`

Return events in one calendar for a required range of at most 31 days. This endpoint is not paginated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `range` | object | Yes | Start and end in matching GMT timed or all-day format, spanning at most 31 days. |
| `timezone` | string | No | IANA timezone Zoho should use when rendering event date and time values. |
| `by_instance` | boolean | No | Return each recurring-event instance separately with the provider's minimal instance fields. |
| `calendar_id` | string | Yes | Opaque calendar UID. |
| `crm_event_type` | string ("own" | "all") | No | CRM-calendar ownership selector. This does not grant or promise Zoho CRM access. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Favorite Resources

**Slug:** `ZOHO_CALENDAR_LIST_FAVORITE_RESOURCES`

Return the connected user's favorite room resources from paid Zoho Resource Booking. Zoho returns the complete, unpaginated Resource array as a JSON-encoded string, which this action preserves exactly.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Group Attendee Statuses

**Slug:** `ZOHO_CALENDAR_LIST_GROUP_ATTENDEE_STATUSES`

Return member RSVP statuses for one group attendee on an event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Opaque event UID. |
| `group_id` | string | Yes | Opaque Zoho group ID whose member statuses to return. |
| `calendar_id` | string | Yes | Opaque calendar UID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Resource Bookings

**Slug:** `ZOHO_CALENDAR_LIST_MY_BOOKINGS`

Return the connected user's room bookings for an exact date range. This unpaginated action requires a paid Zoho plan with Resource Booking enabled and preserves Zoho's JSON-encoded resources and bookings strings exactly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date exactly MM/DD/YYYY and not before start_date. |
| `timezone` | string | No | Optional IANA timezone for the Resource Booking date range. |
| `start_date` | string | Yes | Inclusive start date exactly MM/DD/YYYY. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resource Availability

**Slug:** `ZOHO_CALENDAR_LIST_RESOURCE_AVAILABILITY`

Return room resources and availability for a branch, optional building or floor, and an exact date/time range. This unpaginated endpoint requires a paid Zoho plan with Resource Booking enabled, and the date span cannot exceed the administrator-configured booking duration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | End date exactly MM/dd/yyyy and not earlier than start_date. |
| `end_time` | string | No | Optional end time exactly hh:mm a; requires start_time and must be later. |
| `floor_id` | string | No | Optional opaque floor ID within the branch. |
| `timezone` | string | No | Optional IANA timezone for the branch, such as Asia/Kolkata. |
| `branch_id` | string | Yes | Opaque branch ID. |
| `start_date` | string | Yes | Start date exactly MM/dd/yyyy. |
| `start_time` | string | No | Optional start time exactly hh:mm a; requires end_time. |
| `building_id` | string | No | Optional opaque building ID within the branch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resource Booking User Settings

**Slug:** `ZOHO_CALENDAR_LIST_RESOURCE_BOOKING_USER_SETTINGS`

List user settings for at least one branch, building, or floor in paid Zoho Resource Booking. The connected account must have organization administrator access. Zoho documents this endpoint as unpaginated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `floor_id` | string | No | Opaque floor ID filter. Provide at least one location selector. |
| `branch_id` | string | No | Opaque branch ID filter. Provide at least one location selector. |
| `building_id` | string | No | Opaque building ID filter. Provide at least one location selector. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resource Features

**Slug:** `ZOHO_CALENDAR_LIST_RESOURCE_FEATURES`

Return all feature definitions from paid Zoho Resource Booking. Resource Booking must be enabled for the connected account. Zoho documents this endpoint as an unpaginated bare list.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resources

**Slug:** `ZOHO_CALENDAR_LIST_RESOURCES`

Return room resources for at least one branch, building, or floor. This endpoint requires a paid Zoho plan with Resource Booking enabled and is not paginated. Set include_current_time to select Zoho's resources/current_time response wrapper; otherwise the response is a bare resource array.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `floor_id` | string | No | Opaque floor ID filter. Provide at least one location ID. |
| `branch_id` | string | No | Opaque branch ID filter. Provide at least one location ID. |
| `building_id` | string | No | Opaque building ID filter. Provide at least one location ID. |
| `show_hidden` | boolean | No | Whether to include hidden resources. |
| `include_current_time` | boolean | No | Whether Zoho should return the resources wrapper with current_time. False or omitted returns a bare resource array. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Event

**Slug:** `ZOHO_CALENDAR_MOVE_EVENT`

Move an event between personal or group calendars, optionally changing documented event details; shared and app calendars are unsupported and recurrence changes affect all occurrences. Notification modes 1 and 2 immediately send attendee or attendee-and-organizer notifications that cannot be recalled. To attach a file while moving, first call UPLOAD_EVENT_ATTACHMENT, then pass its returned ID in event_data.attach.file_ids.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Opaque UID of the event to move. |
| `event_data` | object | No | Optional strict changes to apply while moving the event; excludes Zoho Meeting creation. |
| `source_calendar_id` | string | Yes | Opaque source personal or group calendar UID. |
| `destination_calendar_id` | string | Yes | Opaque destination personal or group calendar UID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Event

**Slug:** `ZOHO_CALENDAR_REPLACE_EVENT`

Replace an event using complete date/time data and its latest ETag, without adding Zoho Meeting conferencing. Supplying event_data.attach.remove_attachment_ids permanently removes those attachments; DELETE_EVENT_ATTACHMENTS remains available for dedicated removal. Notification modes 1 and 2 immediately send attendee or attendee-and-organizer notifications that cannot be recalled. To add attachments, first call UPLOAD_EVENT_ATTACHMENT, then pass its returned IDs in event_data.attach.file_ids.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Opaque UID of the event to replace. |
| `event_data` | object | Yes | Strict complete replacement payload with required date_and_time and latest etag; Zoho Meeting creation is unavailable. |
| `calendar_id` | string | Yes | Opaque UID of the calendar containing the event. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unfavorite Resource

**Slug:** `ZOHO_CALENDAR_UNFAVORITE_RESOURCE`

Remove one room from the connected user's favorites. This requires a paid Zoho plan with Resource Booking enabled. It only removes the favorite marker; it does not delete the resource or its bookings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | Opaque ID of the paid Resource Booking room to remove from the connected user's favorites. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource Booking

**Slug:** `ZOHO_CALENDAR_UPDATE_BOOKING`

Update a room booking or selected recurrence occurrences in paid Zoho Resource Booking. Every update must include title, date/time, and resources. Attendee and group arrays apply participant changes rather than replacing the complete lists: omitted participants remain, and deleted=true removes one. Notification modes 1 and 2 immediately send attendee notifications that cannot be recalled. Room availability and administrator-configured booking range limits apply.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `booking_id` | string | Yes | Opaque Zoho Resource Booking booking ID. |
| `booking_data` | object | Yes | Booking data for the update. Zoho requires title, dateandtime, and resources on every update. Existing attendees and groups omitted from their arrays remain; include deleted=true to remove one. Recurrence edit fields must be paired. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource Booking Branch

**Slug:** `ZOHO_CALENDAR_UPDATE_BRANCH`

Update a branch or add or remove its buildings and floors in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission. Removing a building or floor is permanent and can fail while the target is occupied or otherwise in use. Because this endpoint supports permanent removal, ordinary branch edits are also gated as irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `branch_id` | string | Yes | Opaque ID of the Resource Booking branch to update. |
| `branch_data` | object | Yes | Strict non-empty branch, building, floor, or removal update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Calendar

**Slug:** `ZOHO_CALENDAR_UPDATE_CALENDAR`

Update one or more documented properties of an existing calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calendar_id` | string | Yes | Opaque UID of the calendar to update. Pass the raw, unencoded UID. |
| `calendar_data` | object | Yes | Non-empty set of documented calendar properties to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Calendar Settings

**Slug:** `ZOHO_CALENDAR_UPDATE_CALENDAR_SETTINGS`

Update a non-empty set of the connected user's documented Calendar preferences.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `settings_data` | object | Yes | Non-empty object containing only documented Calendar preference updates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Calendar Share

**Slug:** `ZOHO_CALENDAR_UPDATE_CALENDAR_SHARE`

Supports add, edit, and revoke modes for one user or group calendar share; operation='delete' revokes access, so every call is pessimistically gated as destructive.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `share_data` | object | Yes | Strict user or group sharing operation sent to Zoho as shareData. |
| `calendar_id` | string | Yes | Opaque UID of the calendar whose sharing entry should be updated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Event

**Slug:** `ZOHO_CALENDAR_UPDATE_EVENT`

Partially update event fields or attendee data using exactly one documented payload. Supplying event_data.attach.remove_attachment_ids permanently removes those attachments; DELETE_EVENT_ATTACHMENTS remains available for dedicated removal. Notification modes 1 and 2 immediately send attendee or attendee-and-organizer notifications that cannot be recalled. To add attachments, first call UPLOAD_EVENT_ATTACHMENT, then pass its returned IDs in event_data.attach.file_ids.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Opaque UID of the event to update. |
| `event_data` | object | No | Non-empty partial event changes; use instead of attendee_data. |
| `calendar_id` | string | Yes | Opaque UID of the calendar containing the event. |
| `attendee_data` | object | No | Non-empty attendee-only changes; use instead of event_data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource

**Slug:** `ZOHO_CALENDAR_UPDATE_RESOURCE`

Update a room, its feature assignments, or its visibility in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission. Room image upload is not exposed because Zoho does not document the photo transport encoding; its paired image file name is therefore not settable either.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | Opaque ID of the Resource Booking room to update. |
| `resource_data` | object | Yes | Room update requiring resource_name, resource_type, branch_id, building_id, and floor_id. All IDs must be non-empty strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource Booking Organization Settings

**Slug:** `ZOHO_CALENDAR_UPDATE_RESOURCE_BOOKING_ORG_SETTINGS`

Update organization-wide booking limits in paid Zoho Resource Booking. The connected user must be a Zoho organization administrator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `settings_data` | object | Yes | Strict non-empty organization-wide Resource Booking settings update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource Booking User Settings

**Slug:** `ZOHO_CALENDAR_UPDATE_RESOURCE_BOOKING_USER_SETTINGS`

Update user preferences in paid Zoho Resource Booking. By default this targets the connected user; supplying another user's user_id requires organization administrator access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | Opaque Zoho user ID to update. Omit it for the connected user; targeting another user requires organization administrator access. |
| `settings_data` | object | Yes | Strict non-empty Resource Booking user preference update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Resource Feature

**Slug:** `ZOHO_CALENDAR_UPDATE_RESOURCE_FEATURE`

Rename or hide a feature in paid Zoho Resource Booking. The connected user must have Resource Booking administration permission, and the feature type cannot be changed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feature_id` | string | Yes | Opaque ID of the Resource Booking feature to update. |
| `feature_data` | object | Yes | New required name and optional hidden status. The immutable feature type cannot be changed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Event Attachment

**Slug:** `ZOHO_CALENDAR_UPLOAD_EVENT_ATTACHMENT`

Upload one file of at most 10,240 kB. This only uploads the file: next pass the returned fileId as file_ids in the attach object of CREATE_EVENT, UPDATE_EVENT, REPLACE_EVENT, or MOVE_EVENT to associate it with an event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | Attachment file to upload; maximum 10,240 kB. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |