Actions11
Overview
This node integrates with Zoho Bookings to manage appointments programmatically. Specifically, the Reschedule Appointment operation allows users to change the start time of an existing appointment by providing its Booking ID and the new desired start time.
Common scenarios where this node is useful include:
- Automatically updating appointment times based on customer requests or availability changes.
- Synchronizing appointment schedules between Zoho Bookings and other calendar or CRM systems.
- Implementing custom workflows that adjust bookings dynamically without manual intervention.
For example, if a client calls to move their appointment from 10 AM to 2 PM, this node can be used in an automation workflow to update the booking instantly in Zoho Bookings.
Properties
| Name | Meaning |
|---|---|
| Booking ID | The unique identifier of the appointment to reschedule. Found under the "Booking ID" field on the appointment page. Example: #appt-06594. |
| Start Time | The new start time for the appointment. Must follow the format dd-MMM-yyyyTHH:mm:ss (e.g., 30-Apr-2019T22:30:00). |
| Additional Fields | Optional extra parameters. Currently supports selecting the Zoho region (e.g., United States, European Union, India, Australia, China) which determines the API endpoint domain. |
Note: The "Workspace ID" property is not relevant for this operation based on the provided display options.
Output
The node outputs a JSON object under the field zohoResponse containing the response from the Zoho Bookings API after attempting to reschedule the appointment.
The structure of this response depends on Zoho's API but typically includes confirmation details such as updated appointment information or error messages if the rescheduling failed.
No binary data output is produced by this operation.
Dependencies
- Requires an active Zoho Bookings OAuth2 API credential configured in n8n for authentication.
- Uses the Zoho Bookings API endpoint corresponding to the selected region (e.g.,
.com,.eu). - Relies on the
luxonlibrary for date-time formatting. - The node expects the start time input to be correctly formatted and valid according to Zoho's requirements.
Troubleshooting
- Invalid Date Format Error: If the start time does not match the required format (
dd-MMM-yyyyTHH:mm:ss), the API call will fail. Ensure the date-time string is correctly formatted and valid. - Authentication Errors: If the OAuth2 credentials are missing, expired, or invalid, the request to Zoho will be rejected. Verify and refresh credentials as needed.
- Booking ID Not Found: Providing an incorrect or non-existent Booking ID will result in an error from Zoho indicating the appointment cannot be found.
- Time Zone Issues: If specifying a time zone in additional fields, ensure it is valid; otherwise, the API may reject the request or schedule incorrectly.
- API Endpoint Region Mismatch: Selecting the wrong Zoho region in additional fields can cause failures due to hitting the wrong API domain.
To resolve errors, check the exact error message returned in zohoResponse and verify inputs accordingly.