Zoho Bookings icon

Zoho Bookings

Node for Zoho Bookings

Actions11

Overview

This node integrates with Zoho Bookings to retrieve various types of information related to bookings, staff, services, workspaces, and availability times. Specifically, the "Other" resource with the "Get Available Times" operation allows users to fetch available time slots for a given service and staff member within a specified date-time range.

Common scenarios where this node is beneficial include:

  • Scheduling systems that need to display available appointment times dynamically.
  • Automating booking workflows by checking staff availability before confirming appointments.
  • Integrations where availability data from Zoho Bookings must be synchronized or displayed in external applications.

For example, a business could use this node to query available times for a particular service and staff member over the next two weeks, then present those options to customers on a website or app.

Properties

Name Meaning
Service ID The unique identifier of the service for which availability is being requested. It corresponds to the number found in the URL when viewing the service page.
Staff ID The unique identifier of the staff member whose availability is being queried.
Start Of Search Range The start date and time (inclusive) from which to begin searching for available time slots.
End Of Search Range The end date and time (inclusive) up to which to search for available time slots.
Additional Fields Optional extra parameters. Currently supports selecting the Zoho region to target the appropriate API endpoint. Options include: United States of America, European Union, India, Australia, China.

Note: There is a notice property informing users that each day in the search range results in an individual API call, which can increase runtime, API quota usage, and loading time. The search is limited to a maximum of 60 days.

Output

The node outputs JSON data under the field availableTimeSlots. This field contains the list of available time slots returned by Zoho Bookings for the specified service, staff, and date-time range.

The structure of availableTimeSlots typically includes details such as:

  • Date and time of each available slot.
  • Duration or length of the slot.
  • Possibly other metadata about the slot's status or constraints.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Zoho Bookings to authenticate API requests.
  • Uses the Zoho Bookings API endpoint corresponding to the selected region (e.g., .com, .eu, .in, etc.).
  • Relies on the luxon library for date-time formatting and validation.
  • Utilizes helper functions for validating input times and fetching availability data.

Troubleshooting

  • Invalid or missing Service ID or Staff ID: Ensure these IDs are correctly copied from Zoho Bookings URLs or admin panels. Incorrect IDs will cause API errors or empty results.
  • Date range issues: The start date must be before the end date, and both must be valid ISO date-time strings. Violations trigger validation errors.
  • API quota limits: Searching large date ranges (up to 60 days max) results in multiple API calls—exceeding quotas may cause failures.
  • Region mismatch: Selecting the wrong Zoho region in additional fields can lead to authentication or data retrieval errors.
  • Network or authentication errors: Verify that the OAuth2 credentials are valid and have not expired.

Error messages thrown by the node typically indicate the nature of the failure (e.g., invalid parameters, unauthorized access). Users should check parameter correctness and credential validity accordingly.

Links and References

Discussion