Skip to content

Latest commit

 

History

History
110 lines (77 loc) · 3.07 KB

README.md

File metadata and controls

110 lines (77 loc) · 3.07 KB

Zoho Bookings Routing Reference

App name: zoho-bookings Base URL proxied: www.zohoapis.com

API Path Pattern

/zoho-bookings/bookings/v1/json/{endpoint}

Common Endpoints

Workspaces

# List workspaces
GET /zoho-bookings/bookings/v1/json/workspaces

# Get specific workspace
GET /zoho-bookings/bookings/v1/json/workspaces?workspace_id={workspace_id}

# Create workspace
POST /zoho-bookings/bookings/v1/json/createworkspace
Content-Type: application/x-www-form-urlencoded

name=New+Workspace

Services

# List services (workspace_id required)
GET /zoho-bookings/bookings/v1/json/services?workspace_id={workspace_id}

# Create service
POST /zoho-bookings/bookings/v1/json/createservice
Content-Type: application/x-www-form-urlencoded

name=Consultation&workspace_id={workspace_id}&duration=60

Staff

# List staff (workspace_id required)
GET /zoho-bookings/bookings/v1/json/staffs?workspace_id={workspace_id}

Appointments

# Book appointment
POST /zoho-bookings/bookings/v1/json/appointment
Content-Type: application/x-www-form-urlencoded

service_id={service_id}&staff_id={staff_id}&from_time=20-Feb-2026+10:00:00&customer_details={"name":"John","email":"john@example.com","phone_number":"+15551234567"}

# Get appointment
GET /zoho-bookings/bookings/v1/json/getappointment?booking_id=%23NU-00001

# Fetch appointments (uses 'data' wrapper)
POST /zoho-bookings/bookings/v1/json/fetchappointment
Content-Type: application/x-www-form-urlencoded

data={"from_time":"17-Feb-2026 00:00:00","to_time":"20-Feb-2026 23:59:59"}

# Update appointment (cancel/complete/noshow)
POST /zoho-bookings/bookings/v1/json/updateappointment
Content-Type: application/x-www-form-urlencoded

booking_id=#NU-00001&action=cancel

Request Format Notes

  • GET endpoints: Use query parameters
  • POST endpoints: Use application/x-www-form-urlencoded
  • fetchappointment: Requires parameters wrapped in data field as JSON string
  • customer_details: Must be a JSON string, not an object
  • Date format: dd-MMM-yyyy HH:mm:ss (e.g., 20-Feb-2026 10:00:00)

Service Types

  • APPOINTMENT - One-on-one appointments
  • RESOURCE - Resource bookings
  • CLASS - Group classes
  • COLLECTIVE - Collective bookings with multiple staff

Appointment Status Values

  • UPCOMING - Future appointments
  • CANCEL - Cancelled appointments
  • COMPLETED - Completed appointments
  • NO_SHOW - Customer no-shows
  • PENDING - Pending confirmation
  • ONGOING - Currently in progress

Notes

  • Booking IDs include # prefix (URL-encode as %23 in GET requests)
  • The workspace_id is required for services and staff endpoints
  • POST endpoints use form-urlencoded, not JSON body
  • Daily API limits: Free (250), Basic (1,000), Premium/Zoho One (3,000) per user

Resources