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
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--sorting-key`	`string`		Sort by field (created_at, starts_at)
`--sorting-order`	`string`		Sort order (asc, desc)
`--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	Description
`--email`	`string`	Yes	Client email
`--meeting-slug`	`string`	Yes	Meeting slug
`--name`	`string`	Yes	Client name
`--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	Time zone

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.

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

Required arguments:

<id> - Booking UUID or SID

Flag	Type	Description
`--cancel-reason`	`string`	Cancellation reason
`--email`	`string`	Client email (optional; overrides the existing booking’s email when rescheduling)
`--name`	`string`	Client name (optional; overrides the existing booking’s name when rescheduling)
`--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`	Time zone

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.

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

Update a booking

Create a payment

Update a payment

​List bookings

​Show a booking

​Create a booking

​Update a booking

​Create a payment

​Update a payment

List bookings

Show a booking

Create a booking

Update a booking

Create a payment

Update a payment