Meetings

A meeting is a bookable scheduling link. For fields and response details, see the API reference.

List meetings

This command shows scheduling links in your workspace. Use this when you want to inspect available meetings and basic metadata.

neetocal meetings list
neetocal meetings list --search "demo" --host-email host@example.com

Flag	Type	Default	Description
`--host-email`	`string`		Filter by host email
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--search`	`string`		Search meetings

Sample output (--json)

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sid": "abc123x",
      "name": "Product demo",
      "slug": "demo",
      "kind": "one_on_one",
      "duration": 30,
      "disabled": false,
      "spot": "zoom",
      "hosts": [{ "name": "Oliver Smith", "email": "oliver@example.com" }]
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
      "sid": "u9fxy4t",
      "name": "Intro call",
      "slug": "intro",
      "kind": "round_robin",
      "duration": 15,
      "disabled": false,
      "spot": "google_meet",
      "hosts": [{ "name": "Sam Smith", "email": "sam@example.com" }]
    }
  ],
  "breadcrumbs": [
    { "label": "Show details", "command": "neetocal meetings show <sid>" }
  ],
  "pagination": { "total_records": 2, "total_pages": 1, "current_page_number": 1, "page_size": 30 }
}

Show a meeting

This command shows details for one meeting SID. Use this when you want to inspect a meeting’s slug, duration, spot settings, and scheduling rules after finding its SID from meetings list.

neetocal meetings show <sid>

Required arguments:

<sid> - Meeting SID

Sample output (--json)

{
  "data": {
    "meeting": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sid": "abc123x",
      "name": "Product demo",
      "slug": "demo",
      "description": "Discuss project updates",
      "kind": "one_on_one",
      "duration": 30,
      "disabled": false,
      "spot": "zoom",
      "is_multiple_durations_allowed": false,
      "is_multiple_spots_allowed": false,
      "hosts": [{ "name": "Oliver Smith", "email": "oliver@example.com" }]
    }
  },
  "breadcrumbs": [
    { "label": "List meetings", "command": "neetocal meetings list" },
    { "label": "Delete meeting", "command": "neetocal meetings delete abc123x" }
  ]
}

Create a meeting

This command creates a new scheduling link. Use this when you want to add a meeting from the terminal instead of the NeetoCal UI.

neetocal meetings create \
  --name "Product demo" --slug demo \
  --hosts host@example.com --kind one_on_one \
  --spot zoom --duration 30

Flag	Type	Required	Default	Description
`--description`	`string`			Meeting description
`--duration`	`int`	Yes	`0`	Meeting duration in minutes
`--hosts`	`string`	Yes		Comma-separated host emails
`--json-file`	`string`			Path to JSON file with meeting data
`--kind`	`string`			Meeting kind
`--name`	`string`	Yes		Meeting name
`--slug`	`string`	Yes		Meeting slug
`--spot`	`string`			Meeting spot

Sample output (--json)

{
  "data": {
    "meeting": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sid": "abc123x",
      "name": "Product demo",
      "slug": "demo",
      "kind": "one_on_one",
      "duration": 30,
      "disabled": false,
      "spot": "zoom",
      "hosts": [{ "name": "Oliver Smith", "email": "oliver@example.com" }]
    }
  }
}

In --quiet mode this prints the new meeting sid.

Update a meeting

This command updates fields for a meeting SID. Use this when you need to change a meeting’s name, slug, or description from the terminal.

neetocal meetings update <sid> --name "Updated demo" --duration 45

Required arguments:

<sid> - Meeting SID

Flag	Type	Default	Description
`--description`	`string`		Meeting description
`--duration`	`int`	`0`	Meeting duration in minutes
`--hosts`	`string`		Comma-separated host emails (optional; omit to keep current hosts)
`--json-file`	`string`		Path to JSON file with meeting data
`--kind`	`string`		Meeting kind
`--name`	`string`		Meeting name
`--slug`	`string`		Meeting slug
`--spot`	`string`		Meeting spot

Sample output (--json)

{
  "data": {
    "meeting": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sid": "abc123x",
      "name": "Updated demo",
      "slug": "demo",
      "kind": "one_on_one",
      "duration": 45,
      "disabled": false,
      "spot": "zoom",
      "hosts": [{ "name": "Oliver Smith", "email": "oliver@example.com" }]
    }
  }
}

Only the fields you provide are changed. Omit --hosts to keep the current hosts.

Delete a meeting

This command deletes a scheduling link. Use this when you want to remove a meeting without using the NeetoCal UI.

neetocal meetings delete <sid>

Required arguments:

<sid> - Meeting SID to delete

Sample output

Meeting deleted.

In --quiet mode, this prints success.

Create a one-off link

This command creates a one-off scheduling link for a meeting. Use this when you need a single-use booking URL for a specific meeting.

neetocal meetings one-off-link <meeting-sid>

Required arguments:

<meeting-sid> - Meeting SID

Sample output (--json)

{
  "data": {
    "one_off_link": {
      "slug": "one-off-c5530bc7c9ab",
      "url": "https://spinkart.neetocal.com/one-off-c5530bc7c9ab"
    }
  }
}

Returns a single-use booking URL.

List available slots

This command lists available booking dates for a meeting in a given month. Use this when you want to see which days have open slots before creating a booking.

neetocal meetings slots <meeting-sid> --year 2026 --month 5 --day 15 --time-zone "America/New_York"

Required arguments:

<meeting-sid> - Meeting SID

Flag	Type	Required	Default	Description
`--day`	`int`		`0`	Day of month
`--host-email`	`string`			Only slots for this host of a round-robin or multi-host meeting
`--month`	`int`	Yes	`0`	Month (1-12)
`--override-availability`	`bool`		`false`	List every future time, including times outside availability, that can be booked with —override-availability (host or admin only)
`--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
`--year`	`int`	Yes	`0`	Year

Sample output (--json)

{
  "data": [
    {
      "date": "2026-05-15",
      "day": 15,
      "slots": {
        "10:00-10:30": { "start_time": "10:00", "end_time": "10:30", "count": 1 },
        "10:30-11:00": { "start_time": "10:30", "end_time": "11:00", "count": 1 }
      }
    }
  ]
}

Omit --day to retrieve slots for the whole month. For API field details, see Slots. Add --override-availability to list every future time on the meeting’s time increment, including times outside availability, for use with bookings create --override-availability. Only a host of the meeting or an admin can do this. Times another overridden booking already takes show "already_overridden": true.

neetocal meetings slots <meeting-sid> --year 2026 --month 5 --day 15 \
  --time-zone "America/New_York" --override-availability

Sample output (--json)

{
  "data": [
    {
      "date": "2026-05-15",
      "day": 15,
      "slots": {
        "20:00-20:30": { "start_time": "20:00", "end_time": "20:30", "is_available": true, "already_overridden": false },
        "20:30-21:00": { "start_time": "20:30", "end_time": "21:00", "is_available": false, "already_overridden": true }
      }
    }
  ]
}

Durations

Each meeting can offer multiple durations. For API field details, see Meeting durations.

List durations

This command lists duration options for a meeting. Use this when a meeting allows multiple durations and you want to see configured values.

neetocal meetings durations list <meeting-sid>

Required arguments:

<meeting-sid> - Meeting SID

Sample output (--json)

{
  "data": [
    {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 30,
      "is_default": true,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    },
    {
      "id": "5fdf7c7c-5c6f-5d26-a233-b96bf29a2a9d",
      "duration": 45,
      "is_default": false,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  ]
}

Show a duration

This command shows details for one duration on a meeting. Use this after finding the duration ID from meetings durations list.

neetocal meetings durations show <meeting-sid> <id>

Required arguments:

<meeting-sid> - Meeting SID
<id> - Duration UUID

Sample output (--json)

{
  "data": {
    "duration": {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 45,
      "is_default": false,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  }
}

Create a duration

This command adds a duration option to a meeting. Use this when enabling multiple durations on a scheduling link.

neetocal meetings durations create <meeting-sid> --duration 45 --is-default

Required arguments:

<meeting-sid> - Meeting SID

Flag	Type	Required	Default	Description
`--duration`	`int`	Yes	`0`	Duration in minutes
`--is-default`	`bool`		`false`	Set as default duration

Sample output (--json)

{
  "data": {
    "duration": {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 45,
      "is_default": true,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  }
}

Update a duration

This command updates a duration on a meeting. Use this when you need to change duration length or default status.

neetocal meetings durations update <meeting-sid> <id> --duration 60

Required arguments:

<meeting-sid> - Meeting SID
<id> - Duration UUID

Flag	Type	Required	Default	Description
`--duration`	`int`		`0`	Duration in minutes
`--is-default`	`bool`		`false`	Set as default duration

Sample output (--json)

{
  "data": {
    "duration": {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 60,
      "is_default": true,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  }
}

Delete a duration

This command removes a duration from a meeting. Use this when you no longer need a specific duration option.

neetocal meetings durations delete <meeting-sid> <id>

Required arguments:

<meeting-sid> - Meeting SID
<id> - Duration UUID

Sample output

Duration deleted.

In --quiet mode, this prints success.

Spots

A spot is where a meeting happens: Zoom, phone, in person, or another option. In the API, it is called a meeting place.

List spots

This command lists meeting spots (video, phone, in-person) for a meeting. Use this when you want to see configured location options.

neetocal meetings spots list <meeting-sid>

Required arguments:

<meeting-sid> - Meeting SID

Sample output (--json)

{
  "data": [
    {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "zoom",
      "is_default": true,
      "phone_call_number": null,
      "in_person_location": null,
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    },
    {
      "id": "cdd91453-0456-5e90-0255-e36e8d8c4632",
      "spot": "in_person",
      "is_default": false,
      "phone_call_number": null,
      "in_person_location": "Room 4B",
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  ]
}

Show a spot

This command shows details for one meeting spot. Use this after finding the spot ID from meetings spots list.

neetocal meetings spots show <meeting-sid> <id>

Required arguments:

<meeting-sid> - Meeting SID
<id> - Spot UUID

Sample output (--json)

{
  "data": {
    "spot": {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "zoom",
      "is_default": true,
      "phone_call_number": null,
      "in_person_location": null,
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  }
}

Create a spot

This command adds a spot to a meeting. Use this when configuring video, phone, or in-person location options.

neetocal meetings spots create <meeting-sid> --spot zoom --is-default

Required arguments:

<meeting-sid> - Meeting SID

Flag	Type	Required	Default	Description
`--custom-text`	`string`			Custom text for the spot
`--is-default`	`bool`		`false`	Set as default spot
`--location`	`string`			Location for in-person spots
`--phone-number`	`string`			Phone number for phone spots
`--spot`	`string`	Yes		Spot type

Sample output (--json)

{
  "data": {
    "spot": {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "zoom",
      "is_default": true,
      "phone_call_number": null,
      "in_person_location": null,
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  }
}

Update a spot

This command updates a meeting spot. Use this when you need to change spot type, location, or default status.

neetocal meetings spots update <meeting-sid> <id> --location "Room 4B"

Required arguments:

<meeting-sid> - Meeting SID
<id> - Spot UUID

Flag	Type	Default	Description
`--custom-text`	`string`		Custom text for the spot
`--is-default`	`bool`	`false`	Set as default spot
`--location`	`string`		Location for in-person spots
`--phone-number`	`string`		Phone number for phone spots
`--spot`	`string`		Spot type

Sample output (--json)

{
  "data": {
    "spot": {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "in_person",
      "is_default": false,
      "phone_call_number": null,
      "in_person_location": "Room 4B",
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  }
}

Delete a spot

This command removes a spot from a meeting. Use this when you no longer need a specific location option.

neetocal meetings spots delete <meeting-sid> <id>

Required arguments:

<meeting-sid> - Meeting SID
<id> - Spot UUID

Sample output

Spot deleted.

In --quiet mode, this prints success.

Availability

Attach or update the availability schedule a meeting uses. For API field details, see Create meeting availability and Update meeting availability.

Create meeting availability

This command creates an availability schedule linked to a specific meeting. Use this when you need to assign working hours to a host for one scheduling link.

neetocal meetings availabilities create <meeting-sid> \
  --name "Working hours" \
  --email host@example.com \
  --time-zone "America/New_York"

Required arguments:

<meeting-sid> - Meeting SID

Flag	Type	Required	Description
`--email`	`string`	Yes	Email address
`--json-file`	`string`		Path to JSON file with periods/overrides
`--name`	`string`	Yes	Availability name
`--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": {
    "availability": {
      "availability_id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
      "member_id": "b6d02dfa-8ef6-453d-b9f7-67a6f20bcaa6",
      "meeting_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
      "sid": "2nq7q5c",
      "name": "Custom Work Hours",
      "default": false,
      "periods": [
        {
          "id": "21c812a7-3859-4f01-b214-850e6f11caad",
          "wday": "monday",
          "start_time": "09:00 AM",
          "end_time": "05:00 PM"
        }
      ],
      "overrides": []
    }
  }
}

Update meeting availability

This command updates the availability linked to a meeting. Use this when you need to change periods or overrides for a meeting-specific availability.

neetocal meetings availabilities update <meeting-sid> --json-file periods.json

Required arguments:

<meeting-sid> - Meeting SID

Flag	Type	Required	Default	Description
`--json-file`	`string`			Path to JSON file with update data
`--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": {
    "availabilities": [
      {
        "availability_id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
        "member_id": "b6d02dfa-8ef6-453d-b9f7-67a6f20bcaa6",
        "id": "01ea5ddf-ed00-4bed-bfa3-ba8ea80a856a",
        "sid": "2nq7q5c",
        "name": "Custom Work Hours",
        "default": false,
        "periods": [
          {
            "id": "21c812a7-3859-4f01-b214-850e6f11caad",
            "wday": "monday",
            "start_time": "09:00 AM",
            "end_time": "05:00 PM"
          }
        ],
        "overrides": []
      }
    ]
  }
}

Getting started

Commands

List meetings

Show a meeting

Create a meeting

Update a meeting

Delete a meeting

Create a one-off link

List available slots

Durations

List durations

Show a duration

Create a duration

Update a duration

Delete a duration

Spots

List spots

Show a spot

Create a spot

Update a spot

Delete a spot

Availability

Create meeting availability

Update meeting availability

​List meetings

​Show a meeting

​Create a meeting

​Update a meeting

​Delete a meeting

​Create a one-off link

​List available slots

​Durations

​List durations

​Show a duration

​Create a duration

​Update a duration

​Delete a duration

​Spots

​List spots

​Show a spot

​Create a spot

​Update a spot

​Delete a spot

​Availability

​Create meeting availability

​Update meeting availability

List meetings

Show a meeting

Create a meeting

Update a meeting

Delete a meeting

Create a one-off link

List available slots

Durations

List durations

Show a duration

Create a duration

Update a duration

Delete a duration

Spots

List spots

Show a spot

Create a spot

Update a spot

Delete a spot

Availability

Create meeting availability

Update meeting availability