Zoho Bookings

Overview

This node integrates with Zoho Bookings to manage appointment-related actions. Specifically, the "Get Appointment Details" operation retrieves detailed information about a specific appointment using its Booking ID. This is useful for scenarios where you need to fetch and process appointment data within an automated workflow, such as confirming appointment details, sending reminders, or updating records in other systems.

Practical examples:

• Automatically retrieving appointment details after a booking is made to send a confirmation email.
• Fetching appointment information to display in a dashboard or CRM.
• Using appointment data to trigger follow-up workflows based on appointment status or timing.

Properties

The "Additional Fields" property allows specifying the Zoho region domain suffix to direct API requests to the appropriate regional endpoint.

Output

The node outputs a JSON object under the json field containing the key zohoResponse. This holds the full response from the Zoho Bookings API for the requested appointment details. The structure typically includes all relevant appointment information such as customer details, service info, timing, status, and any custom fields associated with the booking.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "zohoResponse": {
    "booking_id": "#appt-06594",
    "service_name": "Consultation",
    "customer_details": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "start_time": "2024-06-15T10:00:00",
    "status": "confirmed",
    ...
  }
}

Dependencies

• Requires an active Zoho Bookings OAuth2 API credential configured in n8n for authentication.
• Uses the Zoho Bookings REST API endpoint, which varies by region (e.g., .com, .eu, .in).
• Relies on the luxon library for date-time formatting internally.
• The node depends on helper functions bundled in the source (getBookingDetails) to perform the API call.

Troubleshooting

• Invalid Booking ID: If the Booking ID is incorrect or does not exist, 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 proper permissions to access the Zoho Bookings API.
• Region Mismatch: Selecting the wrong Zoho region in Additional Fields can cause API endpoint errors or no data returned. Confirm the region corresponds to your Zoho account location.
• API Rate Limits: Excessive calls may lead to rate limiting by Zoho. Implement retry logic or reduce request frequency if needed.
• Date-Time Format Issues: Although not directly applicable here, other operations use strict date-time formats; ensure inputs conform to expected formats to avoid errors.

If an error occurs, the node either throws a detailed error or, if "Continue On Fail" is enabled, returns the error alongside the input data for easier debugging.

Links and References

• Zoho Bookings API Documentation
• Zoho Bookings Official Site
• Luxon DateTime Library