Customers

A customer is a person who raises tickets. For fields and response details, see List customers, Get customer and Create customer in the API reference.

List customers

This command lists the customers in your workspace. Use this when you want to find a customer’s ID. --email filters by an exact email address.

neetodesk customers list
neetodesk customers list --email customer@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)

Show a customer

This command shows one customer. Use this when you want to inspect a customer after finding their ID from customers list.

neetodesk customers show <id>

Required arguments:

<id> - Customer ID

Create a customer

This command adds a customer to the workspace. Use this when you want to set a customer’s name, phone number, and time zone before their first ticket arrives. The email address is what identifies them, and it is the same address tickets create matches on.

neetodesk customers create \
  --email customer@example.com \
  --first-name Sam \
  --last-name Smith \
  --time-zone America/New_York

Flag	Type	Required	Default	Description
`--company-id`	`string`			Company ID to associate
`--description`	`string`			Customer description
`--email`	`stringArray`	Yes	`[]`	Customer email, first is primary (repeat flag for multiple)
`--first-name`	`string`			Customer first name
`--language`	`string`			Preferred language
`--last-name`	`string`			Customer last name
`--link`	`stringArray`		`[]`	Customer link (repeat flag for multiple)
`--phone`	`stringArray`		`[]`	Customer phone number (repeat flag for multiple)
`--time-zone`	`string`			Time zone (e.g. America/New_York)

--email, --phone and --link are repeatable. The first --email is the primary address.

neetodesk customers create \
  --email customer@example.com \
  --email sam.smith@example.org \
  --phone "+1 555 0100"

Sample output (--json)

{
  "data": {
    "customer": {
      "id": "c4d5e6f7-8a9b-40c1-b2d3-e4f5a6b7c8d9",
      "name": "Sam Smith",
      "email": "customer@example.com",
      "language": "English",
      "time_zone": "America/New_York",
      "description": "",
      "created_at": "2026-09-01T10:15:30.000Z",
      "updated_at": "2026-09-01T10:15:30.000Z",
      "emails": ["customer@example.com"],
      "phone_numbers": []
    }
  }
}

The CLI has no command for updating customers.

Getting started

Commands

List customers

Show a customer

Create a customer

​List customers

​Show a customer

​Create a customer

List customers

Show a customer

Create a customer