The bookings command lets you list, inspect, create, update, and manage payments for bookings.
List bookings
This command shows bookings in your workspace. Use this when you want to review upcoming, past, or cancelled bookings.
neetocal bookings list
neetocal bookings list --type=upcoming [email protected] [email protected] --sorting-key=starts_at --sorting-order=descOptional flags:
--client-email- Filter by client email--host-email- Filter by host email--page- Page number--page-size- Items per page--sorting-key- Sort by field (created_at, starts_at)--sorting-order- Sort order (asc, desc)--type- Filter by type (upcoming, past, cancelled, incomplete)--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
SID NAME EMAIL STATUS HOST... HOST EMAIL STARTS AT
────── ────────── ──────────────────── ────── ─────── ────────────────── ───────────────
v7u... Jane C... [email protected] con... Oliver [email protected] 2025-04-24T1...
vrz... Prajna ... prajnajeet.ojha@p... con... Oliver [email protected] 2025-03-31T1...
ez6... Peter S... [email protected] can... Oliver [email protected] 2025-01-22T0...
t3f... Eve Smith [email protected] con... Oliver [email protected] 2025-01-16T0...
b37... Eve Smith [email protected] con... Oliver [email protected] 2025-01-15T0...
Page 1 of 1 (9 total records)Show a booking
This command shows details for one booking. Use this when you want to inspect client info, host, time zone, and status after finding the booking ID from bookings list.
neetocal bookings show b2c3d4e5-f6a7-8901-bcde-f23456789012Required arguments:
<id>- Booking UUID or SID
Optional flags:
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID b2c3d4e5-f6a7-8901-bcde-f23456789012
SID def456y
PARENT BOOKING ID -
NAME Jane Client
EMAIL [email protected]
PHONENUMBER -
NUMBER OF GROUP BOOKING SPOTS 1
HOST NAME Oliver
HOST EMAIL [email protected]
IS MULTIHOST No
MULTIHOSTS [{"email":"[email protected]","name":"Oliver"}]
STARTS AT 2025-04-24T11:00:00.000Z
ENDS AT 2025-04-24T15:00:00.000Z
TIME ZONE Asia/Kolkata
STARTS AT FOR CLIENT 2025-04-24T16:30:00.000+05:30
ENDS AT FOR CLIENT 2025-04-24T20:30:00.000+05:30
STATUS confirmed
CANCEL REASON -
CANCELLED BY -
RESCHEDULE REQUESTED No
PREFERRED MEETING SPOT -
ROOM TYPE google_meet
ROOM URL https://meet.google.com/cba-czqv-ido
ROOM ID -
SPOT DETAILS https://meet.google.com/cba-czqv-ido
CREATED AT 2025-04-22T10:47:59.259Z
UPDATED AT 2025-04-22T10:48:15.005Z
MEETING ID 18c87695-7aa1-457d-b3c2-46b125751c8c
MEETING {"name":"Pair Programming Session"}
NO SHOW No
INTERNAL NOTES -
METADATA -
ADMIN BOOKING URL https://acme.neetocal.com/admin/bookings/def456y
CLIENT BOOKING URL https://acme.neetocal.com/booking/def456y
FORM RESPONSES (3 items)
FORM RESPONSES AS HASH (3 fields)
MEETING OUTCOME -Create a booking
This command creates a new booking. Use this when you want to schedule a meeting on behalf of a client from the terminal.
neetocal bookings create --meeting-slug=consult --name="Jane Client" [email protected] --slot-date=2026-06-25 --slot-start-time=10:00 --time-zone=America/New_YorkRequired flags:
--email- Client email--meeting-slug- Meeting slug--name- Client name--slot-date- Slot date (YYYY-MM-DD)--slot-start-time- Slot start time (HH:MM)--time-zone- Time zone
Optional flags:
--preferred-meeting-spot- Preferred meeting spot--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID b2c3d4e5-f6a7-8901-bcde-f23456789012
SID bkg123x
NAME Jane Client
EMAIL [email protected]
HOST NAME Oliver
HOST EMAIL [email protected]
STATUS confirmed
TIME ZONE America/New_York
STARTS AT FOR CLIENT 2026-06-25T10:00:00.000-04:00
ENDS AT FOR CLIENT 2026-06-25T10:15:00.000-04:00
ADMIN BOOKING URL https://acme.neetocal.com/admin/bookings/bkg123x
CLIENT BOOKING URL https://acme.neetocal.com/booking/bkg123x
FORM RESPONSES AS HASH {"email":"[email protected]","name":"Jane Client"}
...Update a booking
This command updates a booking. Use this when you need to cancel, approve, reject, or reschedule a booking from the terminal.
neetocal bookings update b2c3d4e5-f6a7-8901-bcde-f23456789012 --status=cancelled --cancel-reason="Client requested"Required arguments:
<id>- Booking UUID or SID
Optional flags:
--cancel-reason- Cancellation reason--email- Client email (optional; overrides the existing booking email when rescheduling)--name- Client name (optional; overrides the existing booking name when rescheduling)--rejection-reason- Rejection reason--reschedule-reason- Reschedule reason--slot-date- New slot date (YYYY-MM-DD)--slot-start-time- New slot start time (HH:MM)--status- Status (cancelled, approved, rejected)--time-zone- Time zone--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID b2c3d4e5-f6a7-8901-bcde-f23456789012
SID bkg123x
NAME Jane Client
EMAIL [email protected]
STATUS cancelled
CANCEL REASON Client requested
CANCELLED BY Oliver
UPDATED AT 2026-06-25T10:30:00.000Z
...Create a booking payment
This command creates a payment record for a booking. Use this when processing payments for paid scheduling links.
neetocal bookings payments create b2c3d4e5-f6a7-8901-bcde-f23456789012 --payment-provider=stripe --discount-code=SAVE10Required arguments:
<booking-id>- Booking UUID or SID
Required flags:
--payment-provider- Payment provider
Optional flags:
--discount-code- Discount code--identifier- Payment identifier--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID c3d4e5f6-a7b8-9012-cdef-345678901234
BOOKING ID b2c3d4e5-f6a7-8901-bcde-f23456789012
PAYMENT PROVIDER stripe
STATUS successful
IDENTIFIER pi_abc123
AMOUNT 50
CURRENCY USD
CREATED AT 2026-06-25T10:35:00.000Z
UPDATED AT 2026-06-25T10:35:00.000ZUpdate a booking payment
This command updates a payment for a booking. Use this when you need to mark a payment as successful or rejected.
neetocal bookings payments update b2c3d4e5-f6a7-8901-bcde-f23456789012 00000000-0000-0000-0000-000000000002 --payment-provider=stripe --status=successful --notes="Paid via invoice"Required arguments:
<booking-id>- Booking UUID or SID<payment-id>- Payment UUID
Required flags:
--payment-provider- Payment provider--status- Payment status (successful, rejected)
Optional flags:
--notes- Payment notes--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID c3d4e5f6-a7b8-9012-cdef-345678901234
BOOKING ID b2c3d4e5-f6a7-8901-bcde-f23456789012
PAYMENT PROVIDER stripe
STATUS successful
NOTES Paid via invoice
UPDATED AT 2026-06-25T10:40:00.000Z