Skip to main content
GET
/
forms
/
v2
/
fields
/
{form_guid}
Get all fields from a form
curl --request GET \
  --url https://api.hubapi.com/forms/v2/fields/{form_guid}
[
  {
    "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 ID of the form you're requesting.

Response

Form fields 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