Zoho Bookings

Node for Zoho Bookings

Actions11

Appointment Actions
Other Actions

Overview

This node integrates with Zoho Bookings, a scheduling and appointment management service. It allows users to manage appointments and retrieve various related data such as availability, staff details, workspace information, services, and resources within Zoho Bookings.

Common scenarios where this node is beneficial include:

Automating appointment booking and rescheduling workflows.
Fetching availability slots for services and staff to display in custom booking interfaces.
Managing appointment statuses like cancellation, marking no-shows, or completion.
Retrieving organizational data such as workspace details, staff members, and available services/resources.

For example, a business could use this node to automatically book an appointment when a customer fills out a form on their website, or to fetch available time slots dynamically to show in a booking widget.

Properties

Name	Meaning
Workspace ID	The unique identifier of the workspace in Zoho Bookings. Required when searching by workspace.

Note: The provided property "Workspace ID" is shown only for certain search types (byWorkspaceId, allServicesInWorkspace, byServiceIdServices, byStaffIdServices), indicating it is used to scope queries to a specific workspace.

Output

The node outputs JSON data under the field json with different structures depending on the operation performed:

For appointment-related operations (e.g., booking, rescheduling, getting details, cancelling, marking status), the output contains a zohoResponse field holding the API response from Zoho Bookings about the appointment.
For other retrieval actions:
- getAvailability: Outputs availableTimeSlots containing available booking times for a given service and staff.
- getStaff: Outputs staffInfo with details about a staff member.
- getWorkspace: Outputs workspaceInfo with workspace details.
- getServices: Outputs serviceInfo listing services available in the workspace or for a staff member.
- getResources: Outputs resourcesInfo listing resources associated with a service.

The node does not output binary data.

Dependencies

Requires an OAuth2 API credential for Zoho Bookings to authenticate requests.
Uses the Luxon library for date-time formatting and parsing.
Relies on helper functions for HTTP requests and data fetching defined in bundled dependencies.
Needs proper configuration of the OAuth2 credentials in n8n to connect to Zoho Bookings API endpoints.

Troubleshooting

Authentication errors: Ensure the OAuth2 credentials are correctly set up and authorized for Zoho Bookings API access.
Invalid date/time formats: The node expects date-time inputs in specific formats (e.g., "yyyy-MM-dd HH:mm:ss" or ISO format). Incorrect formats may cause errors.
Missing required parameters: Operations require certain parameters like bookingId, serviceId, or workspaceId. Omitting these will result in errors.
Time zone issues: When specifying time zones, ensure they are valid and supported. The node validates time zones and throws errors if invalid.
API rate limits or network issues: As with any API integration, network failures or hitting Zoho API rate limits can cause errors. Retrying or checking API usage quotas may help.

Error messages typically include context about which item caused the failure, aiding debugging in batch executions.