# SetFieldValueInput (/api/reference/inputs/set-field-value-input)

A field's value to set on one record. Give exactly one of `personId`, `companyId` and `opportunityId`, the one of the field's own kind.

```graphql
input SetFieldValueInput {
  companyId: ID
  fieldDefinitionId: ID!
  opportunityId: ID
  personId: ID
  quote: String
  setBy: FieldValueSetter
  sourceTouchId: ID
  value: SimpleValueInput!
}
```

### Fields [#fields]

#### [`SetFieldValueInput.companyId`](#company-id) · [`ID`](/api/reference/scalars/id) `scalar` [#company-id]
The company to set it on, for a field on companies.

#### [`SetFieldValueInput.fieldDefinitionId`](#field-definition-id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#field-definition-id]
The field's id.

#### [`SetFieldValueInput.opportunityId`](#opportunity-id) · [`ID`](/api/reference/scalars/id) `scalar` [#opportunity-id]
The opportunity to set it on, for a field on opportunities.

#### [`SetFieldValueInput.personId`](#person-id) · [`ID`](/api/reference/scalars/id) `scalar` [#person-id]
The person to set it on, for a field on people.

#### [`SetFieldValueInput.quote`](#quote) · [`String`](/api/reference/scalars/string) `scalar` [#quote]
The words that say it. 10,000 characters at most.

#### [`SetFieldValueInput.setBy`](#set-by) · [`FieldValueSetter`](/api/reference/enums/field-value-setter) `enum` [#set-by]
Who is setting it. `HUMAN` when left out. The AI's writer must say `AI`: that is what lets a person's value stay locked against it.

#### [`SetFieldValueInput.sourceTouchId`](#source-touch-id) · [`ID`](/api/reference/scalars/id) `scalar` [#source-touch-id]
The message, call or meeting the value was read from.

#### [`SetFieldValueInput.value`](#value) · [`SimpleValueInput!`](/api/reference/inputs/simple-value-input) `non-null` `input` [#value]
The value. A value is never empty: use `clearFieldValue` to remove one.

### Member Of [#member-of]

[`setFieldValue`](/api/reference/mutations/set-field-value)  `mutation`