Team members

A team member is a user in your workspace. For fields and response details, see the API reference.

List team members

This command shows active team members in your workspace. Use this when you want to see who already has access before inviting or removing someone.

neetocal team-members list
neetocal team-members list --email oliver@example.com

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

Sample output (--json)

{
  "data": [
    {
      "id": "a1b2c3d4-1111-2222-3333-444455556666",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "America/New_York",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  ],
  "breadcrumbs": [
    { "label": "Show details", "command": "neetocal team-members show <id>" }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

--email matches an address exactly; it does not search by partial address.

Show a team member

This command shows details for one team member ID. Use this when you want to inspect a member’s email, role, time zone, and active status after finding their ID from team-members list.

neetocal team-members show <id>

Required arguments:

<id> - Team member UUID

Sample output (--json)

{
  "data": {
    "team_member": {
      "id": "a1b2c3d4-1111-2222-3333-444455556666",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "America/New_York",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  },
  "breadcrumbs": [
    { "label": "List all team members", "command": "neetocal team-members list" },
    { "label": "Delete team member", "command": "neetocal team-members delete a1b2c3d4-1111-2222-3333-444455556666" }
  ]
}

Add team members

This command invites team members to your workspace. Use this when you want to add colleagues by email and assign an organization role without opening the Team Members page in NeetoCal.

neetocal team-members create \
  --emails oliver@example.com,sam@example.com \
  --organization-role Admin

Flag	Type	Required	Default	Description
`--emails`	`string`	Yes		Comma-separated emails to add
`--invited-by`	`string`			Email of an existing workspace admin
`--json-file`	`string`			Path to JSON file with team member data
`--organization-role`	`string`			Organization role (defaults to Standard)
`--send-invitation-email`	`bool`		`true`	Send an invitation email to the added members

Invites one or more people in a single call. --emails takes a comma-separated list and is required. Omit --organization-role and each invitee is added as Standard. Pass --send-invitation-email=false to add them without sending an invite.

Sample output (--json)

{
  "data": {
    "message": "Users added successfully"
  }
}

The response confirms the request; it does not include a team member record. List or show the member afterwards to retrieve it.

Update a team member

This command updates a team member’s profile or role. Use this when correcting names, email, time zone, or organization role.

neetocal team-members update <id> --first-name Oliver --organization-role Admin

Required arguments:

<id> - Team member UUID

Flag	Type	Description
`--email`	`string`	Email
`--first-name`	`string`	First name
`--json-file`	`string`	Path to JSON file with team member data
`--last-name`	`string`	Last name
`--organization-role`	`string`	Organization role
`--time-zone`	`string`	Time zone

Sample output (--json)

{
  "data": {
    "team_member": {
      "id": "a1b2c3d4-1111-2222-3333-444455556666",
      "email": "oliver@example.com",
      "first_name": "Oliver",
      "last_name": "Smith",
      "time_zone": "America/New_York",
      "profile_image_url": null,
      "active": true,
      "organization_role": "Admin"
    }
  }
}

--organization-role must name a role that already exists in the workspace.

Delete a team member

This command removes a team member from your workspace. Use this when someone should no longer have access.

neetocal team-members delete <id>

Required arguments:

<id> - Team member UUID

Sample output

Team member removed successfully.

Deactivates the member rather than erasing them. --quiet prints success.

Getting Started

Commands

List team members

Show a team member

Add team members

Update a team member

Delete a team member

​List team members

​Show a team member

​Add team members

​Update a team member

​Delete a team member

List team members

Show a team member

Add team members

Update a team member

Delete a team member