# createFieldDefinition (/api/reference/mutations/create-field-definition)

Add a field the workspace keeps on its people, companies or opportunities. It is in use at once. A key the workspace already has on that kind of record is refused (`FIELD_KEY_IN_USE`, naming the field that holds it), so a repeat is refused.

```graphql
createFieldDefinition(
  input: CreateFieldDefinitionInput!
): CreateFieldDefinitionPayload!
```

### Arguments [#arguments]

#### [`createFieldDefinition.input`](#input) · [`CreateFieldDefinitionInput!`](/api/reference/inputs/create-field-definition-input) `non-null` `input` [#input]
The field to add.

### Type [#type]

#### [`CreateFieldDefinitionPayload`](/api/reference/objects/create-field-definition-payload) `object` [#createfielddefinitionpayload-object]
The field that was added.