Create a new object property

curl --request POST \
  --url https://api.hubapi.com/properties/v2/{object_type}/properties \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "label": "<string>",
  "groupName": "<string>",
  "type": "string",
  "fieldType": "textarea",
  "description": "<string>",
  "options": [
    {
      "label": "<string>",
      "value": "<string>",
      "description": "<string>",
      "displayOrder": 123,
      "hidden": true
    }
  ],
  "displayOrder": 123,
  "formField": true
}
'

{
  "name": "<string>",
  "label": "<string>",
  "description": "<string>",
  "groupName": "<string>",
  "type": "string",
  "fieldType": "textarea",
  "options": [
    {
      "description": "<string>",
      "label": "<string>",
      "value": "<string>",
      "displayOrder": 123,
      "hidden": true,
      "readOnly": true,
      "doubleData": 123
    }
  ],
  "displayOrder": 123,
  "formField": true,
  "readOnlyValue": true,
  "readOnlyDefinition": true,
  "hidden": true,
  "mutableDefinitionNotDeletable": true,
  "favorited": true,
  "favoritedOrder": 123,
  "calculated": true,
  "externalOptions": true,
  "displayMode": "<string>",
  "showCurrencySymbol": true,
  "currencyPropertyName": "<string>",
  "textDisplayHint": "<string>",
  "numberDisplayHint": "<string>",
  "optionsAreMutable": true,
  "referencedObjectType": "<string>",
  "isCustomizedDefault": true,
  "searchableInGlobalSearch": true,
  "hasUniqueValue": true,
  "hubspotDefined": true,
  "deleted": true,
  "createdAt": 123,
  "updatedAt": 123,
  "createdUserId": 123,
  "updatedUserId": 123
}

POST

properties

{object_type}

properties

Create a new object property

curl --request POST \
  --url https://api.hubapi.com/properties/v2/{object_type}/properties \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "label": "<string>",
  "groupName": "<string>",
  "type": "string",
  "fieldType": "textarea",
  "description": "<string>",
  "options": [
    {
      "label": "<string>",
      "value": "<string>",
      "description": "<string>",
      "displayOrder": 123,
      "hidden": true
    }
  ],
  "displayOrder": 123,
  "formField": true
}
'

{
  "name": "<string>",
  "label": "<string>",
  "description": "<string>",
  "groupName": "<string>",
  "type": "string",
  "fieldType": "textarea",
  "options": [
    {
      "description": "<string>",
      "label": "<string>",
      "value": "<string>",
      "displayOrder": 123,
      "hidden": true,
      "readOnly": true,
      "doubleData": 123
    }
  ],
  "displayOrder": 123,
  "formField": true,
  "readOnlyValue": true,
  "readOnlyDefinition": true,
  "hidden": true,
  "mutableDefinitionNotDeletable": true,
  "favorited": true,
  "favoritedOrder": 123,
  "calculated": true,
  "externalOptions": true,
  "displayMode": "<string>",
  "showCurrencySymbol": true,
  "currencyPropertyName": "<string>",
  "textDisplayHint": "<string>",
  "numberDisplayHint": "<string>",
  "optionsAreMutable": true,
  "referencedObjectType": "<string>",
  "isCustomizedDefault": true,
  "searchableInGlobalSearch": true,
  "hasUniqueValue": true,
  "hubspotDefined": true,
  "deleted": true,
  "createdAt": 123,
  "updatedAt": 123,
  "createdUserId": 123,
  "updatedUserId": 123
}

Scope requirements

Path Parameters

object_type

string

required

The specific type of CRM object to create the property for. You can use the object name (e.g., contacts) or the objectTypeId (e.g., 0-1).

Body

application/json

name

string

required

The internal name of the property. Must be unique and start with a lowercase letter.

label

string

required

A human readable label for the property

groupName

string

required

The property group that the property belongs to

type

enum<string>

required

The data type that the property stores

Available options:

string,

number,

bool,

datetime,

enumeration

fieldType

enum<string>

required

Controls how the property appears when used in forms

Available options:

textarea,

select,

text,

date,

file,

number,

radio,

checkbox

description

string

A description of the property

options

object[]

Options for enumeration properties

Show child attributes

displayOrder

integer

Used to control the default order of the property within the property group

formField

boolean

Whether the property can be used in forms

Response

201 - application/json

Object property created successfully

name

string

The internal name of the property

label

string

A human readable label for the property

description

string

A description of the property

groupName

string

The property group that the property belongs to

type

enum<string>

The data type that the property stores

Available options:

string,

number,

bool,

datetime,

enumeration

fieldType

enum<string>

Controls how the property appears when used in forms

Available options:

textarea,

select,

text,

date,

file,

number,

radio,

checkbox

options

object[]

Options for enumeration properties

Show child attributes

displayOrder

integer

Used to control the default order of the property within the property group

formField

boolean

Whether the property can be used in forms

readOnlyValue

boolean

Whether the property value is read-only

readOnlyDefinition

boolean

Whether the property definition is read-only

hidden

boolean

Whether the property is hidden

mutableDefinitionNotDeletable

boolean

Whether the property definition can be deleted

favorited

boolean

Whether the property is favorited

favoritedOrder

integer

The order of the property in the favorites list

calculated

boolean

Whether the property is calculated

externalOptions

boolean

Whether the property uses external options

displayMode

string

The display mode of the property

showCurrencySymbol

boolean

Whether to show currency symbol for number properties

currencyPropertyName

string

Name of the property that defines the currency

textDisplayHint

string

Display hint for text properties

numberDisplayHint

string

Display hint for number properties

optionsAreMutable

boolean

Whether the options can be modified

referencedObjectType

string

Referenced object type for relationship properties

isCustomizedDefault

boolean

Whether this is a customized default property

searchableInGlobalSearch

boolean

Whether the property is searchable in global search

hasUniqueValue

boolean

Whether the property must have unique values

hubspotDefined

boolean

Whether the property is defined by HubSpot

deleted

boolean

Whether the property has been deleted

createdAt

integer

Timestamp when the property was created

updatedAt

integer

Timestamp when the property was last updated

createdUserId

integer

The ID of the user who created the property

updatedUserId

integer

The ID of the user who last updated the property

Last modified on December 12, 2025