Skip to main content
GET
/
forms
/
v2
/
fields
/
{form_guid}
/
{field_name}
Get a single field from a form
curl --request GET \
  --url https://api.hubapi.com/forms/v2/fields/{form_guid}/{field_name}
{
  "name": "<string>",
  "label": "<string>",
  "type": "<string>",
  "fieldType": "<string>",
  "description": "<string>",
  "groupName": "<string>",
  "displayOrder": 123,
  "required": true,
  "selectedOptions": [
    "<string>"
  ],
  "options": [
    {}
  ],
  "validation": {
    "name": "<string>",
    "message": "<string>",
    "data": "<string>",
    "useDefaultBlockList": true,
    "blockedEmailAddresses": [
      "<string>"
    ]
  },
  "enabled": true,
  "hidden": true,
  "defaultValue": "<string>",
  "isSmartField": true,
  "unselectedLabel": "<string>",
  "placeholder": "<string>",
  "dependentFieldFilters": [
    {}
  ],
  "labelHidden": true,
  "propertyObjectType": "<string>",
  "metaData": [
    {}
  ],
  "objectTypeId": "<string>"
}

Path Parameters

form_guid
string
required

The unique ID for the form that you're requesting the field from in your API call.

field_name
string
required

The name of the specific field that you're requesting in your API call.

Response

Form field retrieved successfully

name
string
required

The name of the field

label
string
required

The label of the field

type
string
required

The type of the field

fieldType
string
required

The field type

description
string

The description of the field

groupName
string

The group name

displayOrder
integer

The display order

required
boolean

Whether the field is required

selectedOptions
string[]
options
object[]
validation
object
enabled
boolean

Whether the field is enabled

hidden
boolean

Whether the field is hidden

defaultValue
string

The default value

isSmartField
boolean

Whether this is a smart field

unselectedLabel
string

The unselected label

placeholder
string

The placeholder text

dependentFieldFilters
object[]
labelHidden
boolean

Whether the label is hidden

propertyObjectType
string

The property object type

metaData
object[]
objectTypeId
string

The object type ID

Last modified on December 12, 2025