> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetodesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customers

> List, view, and create the customers who raise tickets.

A customer is a person who raises tickets. For fields and response details, see the [API reference](/api/customers/create).

## 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.

```bash theme={"system"}
neetodesk customers list
neetodesk customers list --email customer@example.com
```

| Flag | Type | Required | 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`.

```bash theme={"system"}
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`](/cli-reference/tickets#create-a-ticket) matches on.

```bash theme={"system"}
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` | `string` | Yes | | Customer email |
| `--first-name` | `string` | | | Customer first name |
| `--language` | `string` | | | Preferred language |
| `--last-name` | `string` | | | Customer last name |
| `--phone` | `string` | | | Customer phone number |
| `--time-zone` | `string` | | | Time zone (e.g. America/New\_York) |

```json Sample output (--json) theme={"system"}
{
  "data": {
    "customer": {
      "id": "c4d5e6f7-8a9b-40c1-b2d3-e4f5a6b7c8d9",
      "name": "Sam Smith",
      "email": "customer@example.com"
    }
  }
}
```

The CLI has no command for updating customers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.