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

# customerCustomFieldDeclarationCreate

> Create a typed customer custom field declaration in this store's catalog without writing a customer record. Idempotent when a declaration with the same name and dataType already exists; errors with `CUSTOM_FIELD_TYPE_CONFLICT` if one exists with a different dataType.

**Required scopes:** [`customers_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-customers_write)

**Store must have one of:** `EMAIL_SMS`

## Arguments

**input** `[CustomerCustomFieldDeclarationCreateInput!](/docs/api-reference/v3/reference/marketing/customer-custom-field-declaration-create-input)` *required*

Name, data type, and optional picklist options.

**fields**

**dataType** `[CustomerCustomFieldDataType!](/docs/api-reference/v3/reference/marketing/customer-custom-field-data-type)` *required*

The value type stored by this custom field.

**isMultiValued** `Boolean`

Whether a customer can hold multiple values for this field. Defaults to false.

**name** `String!` *required*

The merchant-facing name of the custom field.

**options** `[String!]`

Optional allowed picklist values, encoded as strings matching `dataType`. At most 500.

## Returns

**customerCustomFieldDeclarationCreate** `[CustomerCustomFieldDeclaration!](/docs/api-reference/v3/reference/marketing/customer-custom-field-declaration)` *required*

A typed custom field declaration (custom property) on this store's customers.

**fields**

**createdAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When this custom field declaration was created.

**dataType** `[CustomerCustomFieldDataType!](/docs/api-reference/v3/reference/marketing/customer-custom-field-data-type)` *required*

The value type of the custom field.

**id** `ID!` *required*

The id of this custom field declaration.

**isMultiValued** `Boolean!` *required*

Whether a customer can hold multiple values for this field.

**legacyId** `String`

The declaration's legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.

**name** `String!` *required*

The merchant-facing name of the custom field.

**options** `[String!]!` *required*

Allowed picklist values when defined, encoded as strings. Empty when unrestricted.

**updatedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When this custom field declaration was last updated.

## Example

```graphql theme={null}
mutation {
  customerCustomFieldDeclarationCreate(input: { ... }) {
    createdAt
    dataType
    id
    isMultiValued
    legacyId
    name
    options
    updatedAt
  }
}
```


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