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

> Create the customers who raise tickets.

Customers are the people who raise tickets. For fields and response details, see the
[API reference](/api-reference/customers/create).

<Note>
  Sample output on this page is shown as the `--json` envelope, which is reproducible. Pretty
  tables depend on your terminal width. See [Output formats](/cli/output-formats).
</Note>

## customers create

Adds a customer to the workspace. The email address is what identifies them, and it is the same
address [`tickets create`](/cli-reference/tickets#tickets-create) matches on, so creating a
customer up front lets you set their name, phone number and time zone before their first ticket
arrives.

```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 theme={"system"}
{
  "data": {
    "customer": {
      "id": "c4d5e6f7-8a9b-40c1-b2d3-e4f5a6b7c8d9",
      "name": "Sam Smith",
      "email": "customer@example.com"
    }
  }
}
```

The CLI has no command for reading or updating customers. Fetch a ticket with
[`tickets show`](/cli-reference/tickets#tickets-show) to see the customer attached to it.