View as Markdown
Zoho Bookings icon

Zoho Bookings ACTION

Book Appointment

Book an appointment for a customer for a desired service. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Zoho Bookings account once, then configure and run Book Appointment from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "zoho_bookings-book-appointment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoho_bookings: { authProvisionId: "apn_xxxxxxx" },
    serviceId: "Service ID",
    staffId: "Staff ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Book Appointment inputs
Property Type Description
serviceId Service ID string
The ID of the service for the appointment
Required Dynamic
staffId Staff ID string
The ID of the staff member for the appointment. Either staff or resource is mandatory
Optional Dynamic
resourceId Resource ID string
The ID of the resource for the appointment. Either resource or staff is mandatory
Optional Dynamic
fromTime From Time string
The starting time from which the appointment needs to be booked. (24-hour time format) format: dd-MMM-yyyy HH:mm:ss (e.g. 30-Apr-2019 22:00:00)
Required
customerDetails Customer Details object
The details of the customer for the appointment
Required
timeZone Time Zone string
The time zone of the appointment
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
zoho_bookings-book-appointment
Version
0.0.2
App
Zoho Bookings
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes