Zoho Bookings icon

Zoho Bookings

Node for Zoho Bookings
Join our community

Actions11

Overview

This node integrates with Zoho Bookings to manage appointments programmatically. Specifically, the "Cancel Appointment" operation allows users to cancel an existing appointment by providing its Booking ID. This is useful in scenarios where automated workflows need to update appointment statuses based on external triggers or business logic, such as cancelling appointments when a customer requests it via a form or when a related event occurs.

Practical examples:

  • Automatically cancel appointments if a payment fails.
  • Cancel appointments when a staff member becomes unavailable.
  • Integrate with CRM systems to reflect appointment cancellations.

Properties

Name Meaning
Booking ID The unique identifier of the appointment to be cancelled. It corresponds to the "Booking ID" shown on the appointment page (e.g., "#appt-06594"). This field is required.
Additional Fields Optional extra parameters for the request. Currently supports selecting the Zoho region to target the appropriate API endpoint. Available regions: United States of America (.com), European Union (.eu), India (.in), Australia (.com.au), China (.com.cn).

Output

The node outputs a JSON object under the json property containing the raw response from the Zoho Bookings API after attempting to cancel the appointment. This response typically includes confirmation of the cancellation status and any relevant metadata returned by Zoho.

No binary data output is produced by this operation.

Example output structure snippet:

{
  "zohoResponse": {
    "status": "success",
    "message": "Appointment cancelled successfully",
    ...
  }
}

Dependencies

  • Requires an active Zoho Bookings OAuth2 API credential configured in n8n for authentication.
  • Uses the Zoho Bookings REST API endpoint, which varies depending on the selected region.
  • Relies on the luxon library for date/time formatting internally (not directly exposed to user).
  • Utilizes helper functions bundled within the node's codebase for making authenticated HTTP requests and updating booking status.

Troubleshooting

  • Invalid Booking ID: If the provided Booking ID does not exist or is malformed, the API will return an error. Verify the Booking ID matches exactly what is shown in Zoho Bookings.
  • Authentication Errors: Ensure the OAuth2 credentials are valid and have sufficient permissions to modify bookings.
  • Region Mismatch: Selecting the wrong Zoho region may cause API calls to fail or return unexpected results. Confirm the region matches your Zoho account location.
  • API Rate Limits: Frequent cancellations might hit Zoho API rate limits; consider adding delays or error handling to retry later.
  • Network Issues: Connectivity problems can cause request failures; check network access and proxy settings if applicable.

Common error messages:

  • "Invalid Booking ID": Check the bookingId input.
  • "Unauthorized" or "Access Denied": Reauthenticate or verify API credentials.
  • "Resource Not Found": The appointment may already be cancelled or deleted.

Links and References

Discussion