Bookings

A booking is a scheduled meeting between a host and a client. For fields and response details, see the API reference.

List bookings

This command shows bookings in your workspace. Use this when you want to review upcoming, past, or cancelled bookings.

neetocal bookings list --type upcoming
neetocal bookings list --client-email oliver@example.com --sorting-key starts_at --sorting-order asc

Flag	Type	Default	Description
`--client-email`	`string`		Filter by client email
`--host-email`	`string`		Filter by host email
`--meeting-sid`	`string`		Filter by meeting SID
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--search`	`string`		Search text, min 3 chars (client name/email/sid, meeting name, host name/email, form answers)
`--sorting-key`	`string`		Sort by field (created_at, starts_at)
`--sorting-order`	`string`		Sort order (asc, desc)
`--starts-after`	`string`		Only bookings starting at or after this time (ISO 8601 datetime or YYYY-MM-DD)
`--starts-before`	`string`		Only bookings starting before this time (ISO 8601 datetime or YYYY-MM-DD)
`--type`	`string`		Filter by type (upcoming, past, cancelled, incomplete)

Sample output (--json)

{
  "data": [
    {
      "id": "efb296a3-8205-419f-8ac4-1abfc46bc3c7",
      "sid": "8sqtzrs",
      "name": "Oliver Smith",
      "email": "oliver@example.com",
      "host_name": "Sam Smith",
      "host_email": "host@example.com",
      "starts_at": "2026-05-15T10:00:00.000Z",
      "ends_at": "2026-05-15T10:30:00.000Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "meeting": { "name": "Product demo" }
    },
    {
      "id": "f1a3b5c7-9d2e-4f60-8b1a-2c3d4e5f6a7b",
      "sid": "9tru0as",
      "name": "Eve Smith",
      "email": "eve@example.com",
      "host_name": "Sam Smith",
      "host_email": "host@example.com",
      "starts_at": "2026-05-16T14:00:00.000Z",
      "ends_at": "2026-05-16T14:30:00.000Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "meeting": { "name": "Product demo" }
    }
  ],
  "pagination": { "total_records": 2, "total_pages": 1, "current_page_number": 1, "page_size": 30 }
}

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 <id>

Required arguments:

<id> - Booking UUID or SID

Sample output (--json)

{
  "data": {
    "booking": {
      "id": "efb296a3-8205-419f-8ac4-1abfc46bc3c7",
      "sid": "8sqtzrs",
      "name": "Oliver Smith",
      "email": "oliver@example.com",
      "host_name": "Sam Smith",
      "host_email": "host@example.com",
      "starts_at": "2026-05-15T10:00:00.000Z",
      "ends_at": "2026-05-15T10:30:00.000Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "preferred_meeting_spot": "zoom",
      "meeting_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "meeting": { "name": "Product demo" },
      "meeting_outcome": null,
      "admin_booking_url": "https://spinkart.neetocal.com/admin/bookings/8sqtzrs",
      "client_booking_url": "https://spinkart.neetocal.com/booking/8sqtzrs"
    }
  }
}

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 demo \
  --name "Oliver Smith" \
  --email oliver@example.com \
  --slot-date 2026-05-15 \
  --slot-start-time 10:00 \
  --time-zone "America/New_York"

Flag	Type	Required	Default	Description
`--email`	`string`	Yes		Client email
`--host-email`	`string`			Host to assign on a meeting with several hosts (needs —override-availability unless clients can choose the host)
`--meeting-slug`	`string`	Yes		Meeting slug
`--name`	`string`	Yes		Client name
`--override-availability`	`bool`		`false`	Book the slot even if it is outside the meeting’s availability (host or admin only)
`--preferred-meeting-spot`	`string`			Preferred meeting spot
`--slot-date`	`string`	Yes		Slot date (YYYY-MM-DD)
`--slot-start-time`	`string`	Yes		Slot start time (HH:MM)
`--time-zone`	`string`	Yes		IANA time zone name, e.g. America/New_York. Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Sample output (--json)

{
  "data": {
    "booking": {
      "id": "efb296a3-8205-419f-8ac4-1abfc46bc3c7",
      "sid": "8sqtzrs",
      "name": "Oliver Smith",
      "email": "oliver@example.com",
      "host_name": "Sam Smith",
      "host_email": "host@example.com",
      "starts_at": "2026-05-15T10:00:00.000Z",
      "ends_at": "2026-05-15T10:30:00.000Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "meeting": { "name": "Product demo" },
      "meeting_outcome": null
    }
  }
}

Pull valid slots first with neetocal meetings slots, then pass one to --slot-date / --slot-start-time. In --quiet mode this prints the new booking id.

Book outside availability

Add --override-availability to book a time outside the meeting’s availability. Available hours, minimum notice, buffer time, booking limits, the maximum bookings per slot of a group meeting, holidays, calendar conflicts and existing bookings are ignored. Only a host of the meeting or an admin can do this. Past times are still refused, and a host can’t have two overridden bookings at the same time.

neetocal bookings create \
  --meeting-slug demo \
  --name "Oliver Smith" \
  --email oliver@example.com \
  --slot-date 2026-05-15 \
  --slot-start-time 20:00 \
  --time-zone "America/New_York" \
  --override-availability

The booking in the output has "is_overridden": true and a bypassed_rules list of the rules that were skipped. On a meeting with several hosts, pass --host-email to choose who gets the booking. To see which times can be booked this way, run neetocal meetings slots with --override-availability.

Update a booking

This command updates a booking. Use this when you need to cancel, approve, reject, or reschedule a booking from the terminal. Reschedule, cancel, approve, or reject a booking. Only the flags you set are sent.

# Reschedule
neetocal bookings update <id> \
  --slot-date 2026-05-22 --slot-start-time 14:00 --time-zone "America/New_York" \
  --reschedule-reason "Client conflict"

# Cancel
neetocal bookings update <id> --status cancelled --cancel-reason "No longer needed"

# Approve
neetocal bookings update <id> --status approved

# Reschedule outside the meeting's availability (host or admin only)
neetocal bookings update <id> \
  --slot-date 2026-05-22 --slot-start-time 21:00 --time-zone "America/New_York" \
  --override-availability

Required arguments:

<id> - Booking UUID or SID

Flag	Type	Default	Description
`--cancel-reason`	`string`		Cancellation reason
`--email`	`string`		Client email (optional; overrides the existing booking’s email when rescheduling)
`--meeting-outcome-id`	`string`		Meeting outcome ID (pass an empty string to clear the outcome)
`--name`	`string`		Client name (optional; overrides the existing booking’s name when rescheduling)
`--override-availability`	`bool`	`false`	Reschedule even if the new slot is outside the meeting’s availability (host or admin only; use with —slot-date and —slot-start-time)
`--preferred-meeting-spot`	`string`		Preferred meeting spot for the rescheduled slot (use with —slot-date and —slot-start-time)
`--rejection-reason`	`string`		Rejection reason
`--reschedule-reason`	`string`		Reschedule reason
`--slot-date`	`string`		New slot date (YYYY-MM-DD)
`--slot-start-time`	`string`		New slot start time (HH:MM)
`--status`	`string`		Status (cancelled, approved, rejected)
`--time-zone`	`string`		IANA time zone name, e.g. America/New_York. Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Sample output (--json)

{
  "data": {
    "booking": {
      "id": "efb296a3-8205-419f-8ac4-1abfc46bc3c7",
      "sid": "8sqtzrs",
      "name": "Oliver Smith",
      "email": "oliver@example.com",
      "host_name": "Sam Smith",
      "host_email": "host@example.com",
      "starts_at": "2026-05-22T14:00:00.000Z",
      "ends_at": "2026-05-22T14:30:00.000Z",
      "time_zone": "America/New_York",
      "status": "confirmed",
      "reschedule_requested": false,
      "meeting": { "name": "Product demo" },
      "meeting_outcome": null
    }
  }
}

Rescheduling keeps the existing client details. Pass --name or --email only to replace them. --override-availability follows the same rules as creating a booking outside availability. The booking keeps its current host.

Create a payment

This command creates a payment record for a booking. Use this when processing payments for paid scheduling links.

neetocal bookings payments create <booking-id> \
  --payment-provider stripe --discount-code SUMMER25

Required arguments:

<booking-id> - Booking UUID or SID

Flag	Type	Required	Description
`--discount-code`	`string`		Discount code
`--identifier`	`string`		Payment identifier
`--payment-provider`	`string`	Yes	Payment provider

Sample output (--json)

{
  "data": {
    "payment": {
      "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
      "identifier": "ext-123",
      "status": "confirmation_pending",
      "amount": "100.0",
      "currency": "USD"
    }
  }
}

Update a 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 <booking-id> <payment-id> \
  --payment-provider stripe --status successful --notes "Paid in full"

Required arguments:

<booking-id> - Booking UUID or SID
<payment-id> - Payment UUID

Flag	Type	Required	Description
`--notes`	`string`		Payment notes
`--payment-provider`	`string`	Yes	Payment provider
`--status`	`string`	Yes	Payment status (successful, rejected)

Sample output (--json)

{
  "data": {
    "payment": {
      "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
      "identifier": "ext-123",
      "status": "successful",
      "amount": "100.0",
      "currency": "USD"
    }
  }
}

Getting started

Commands

List bookings

Show a booking

Create a booking

Book outside availability

Update a booking

Create a payment

Update a payment

​List bookings

​Show a booking

​Create a booking

​Book outside availability

​Update a booking

​Create a payment

​Update a payment

List bookings

Show a booking

Create a booking

Book outside availability

Update a booking

Create a payment

Update a payment