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

# roark customer field create

> Create a customer field

Adds a field of your project's own. With extract on, conversations fill it from what customers say, guided by its description.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark customer field create [options]
```

> [!NOTE]
>
> Calls `POST /v1/customer/fields`

## Options

**--key** `string` *required*

Starts with a letter; letters, numbers and underscores only. Fixed once created.

**--label** `string` *required*

**--description** `string`

What the agent listens for in a conversation. Required when extract is true.

**--value-type** `string` *required*

One of `TEXT`, `NUMBER`, `BOOLEAN`, `DATE`, `PHONE_NUMBER`, `EMAIL`, `CURRENCY`

**--extract** `switch` *required*

Whether conversations fill this field.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark customer field create --key <value> --label <value> --value-type <value> --extract <value>
```

Every command also takes the [global options](https://docs.roark.ai/cli-reference/overview.md#global-options) and sets one
of the [exit codes](https://docs.roark.ai/cli-reference/overview.md#exit-codes).


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