Update Custom Field

PUT 
/locations/:locationId/customFields/:id

Update Custom Field

Request

Version stringrequired

API Version

Available options2021-04-15

locationId stringrequired

Location Id

id stringrequired

Custom Field Id

application/json

application/json

Body

Bodyrequired

namestringrequired
placeholderstring
acceptedFormatstring[]
isMultipleFileboolean
maxNumberOfFilesnumber
textBoxListOptionsobject[]
positionnumber
Default value: 0
modelstring
Model of the custom field you want to update
Available optionscontactopportunity
urlValidationobject

When provided, replaces URL validation rules (URL fields only).

dateTimeValidationobject

When provided, replaces date/time validation rules (DATE, TIME, DATE_TIME fields only).

userFieldConfigobject

When provided, updates user field options except multiSelect (immutable after create).

optionDisplayTypestring
When provided, updates the option rendering mode (RADIO / CHECKBOX only). One of TEXT_ONLY, TEXT_WITH_ICON, TEXT_WITH_IMAGE.
Available optionsTEXT_ONLYTEXT_WITH_ICONTEXT_WITH_IMAGE

Example (auto)

{
  "name": "Custom Field",
  "placeholder": "Placeholder Text",
  "acceptedFormat": [
    ".pdf",
    ".docx",
    ".jpeg"
  ],
  "isMultipleFile": false,
  "maxNumberOfFiles": 2,
  "textBoxListOptions": [
    {
      "label": "First",
      "prefillValue": ""
    }
  ],
  "position": 0,
  "model": "opportunity",
  "urlValidation": {
    "mode": "allow_only",
    "allowedDomains": [
      "example.com"
    ]
  },
  "dateTimeValidation": {
    "mode": "range",
    "rangeMin": "2026-01-01",
    "rangeMax": "2026-12-31"
  },
  "userFieldConfig": {
    "multiSelect": false
  },
  "optionDisplayType": "TEXT_WITH_IMAGE"
}

application/json

Successful response

application/json

Schema

Schema

customFieldobject

Example (auto)

{
  "customField": {
    "id": "3sv6UEo51C9Bmpo1cKTq",
    "name": "pincode",
    "fieldKey": "contact.pincode",
    "placeholder": "Pin code",
    "dataType": "TEXT",
    "position": 0,
    "picklistOptions": [
      "first option"
    ],
    "picklistImageOptions": [],
    "isAllowedCustomOption": false,
    "isMultiFileAllowed": true,
    "maxFileLimit": 4,
    "locationId": "3sv6UEo51C9Bmpo1cKTq",
    "model": "opportunity",
    "urlValidation": {
      "mode": "allow_only",
      "allowedDomains": [
        "example.com"
      ]
    },
    "dateTimeValidation": {
      "mode": "range",
      "rangeMin": "2026-01-01",
      "rangeMax": "2026-12-31"
    },
    "userFieldConfig": {
      "multiSelect": false
    },
    "optionDisplayType": "TEXT_WITH_IMAGE"
  }
}