Skip to main content
PATCH
Update property

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

objectTypeId
string
required

The unique identifier of the object type whose property you want to update.

propertyName
string
required

The name of the property to update.

Body

application/json
accessAllowlist
object[]

An array of PublicAccessAllowlistEntry objects that define the access permissions for the property.

archived
boolean

A boolean indicating whether the property is archived.

calculationFormula
object

An object representing the calculation formula for the property. The specific properties are not detailed in the spec.

currencyPropertyName
object
dataEntryInstructions
object

An object providing instructions for data entry. The specific properties are not detailed in the spec.

dataSensitivity
object

An object representing the sensitivity level of the data. The specific properties are not detailed in the spec.

dateDisplayFormat
object
defaultValue
object

An object indicating the default value for the property. The specific properties are not detailed in the spec.

description
object

An object providing a description of the property. The specific properties are not detailed in the spec.

fieldType
enum<string>

A string specifying the field type of the property. Valid options include 'BOOLEANCHECKBOX', 'CALCULATION_EQUATION', 'CALCULATION_READ_TIME', 'CALCULATION_ROLLUP', 'CALCULATION_SCORE', 'CHECKBOX', 'DATE', 'EMAIL', 'FILE', 'HTML', 'NUMBER', 'PHONE_NUMBER', 'RADIO', 'SELECT', 'TEXT', 'TEXTAREA', 'UNKNOWN', and 'URL'.

Available options:
BOOLEANCHECKBOX,
CALCULATION_EQUATION,
CALCULATION_READ_TIME,
CALCULATION_ROLLUP,
CALCULATION_SCORE,
CHECKBOX,
DATE,
EMAIL,
FILE,
HTML,
NUMBER,
PHONE_NUMBER,
RADIO,
SELECT,
TEXT,
TEXTAREA,
UNKNOWN,
URL
formField
boolean

A boolean indicating whether the property is used as a form field.

groupName
string

A string representing the group name to which the property belongs.

hasUniqueValue
boolean

A boolean indicating whether the property must have a unique value.

label
string

A string representing the display name of the property.

numberDisplayFormat
object
optionDecorators
object

An object representing the option decorators for the property. The specific properties are not detailed in the spec.

options
object

An object representing the available options for the property. The specific properties are not detailed in the spec.

rollupConfig
object

An object representing the rollup configuration for the property. The specific properties are not detailed in the spec.

sensitiveDataCategories
object
syncConfig
object

An object representing the synchronization configuration for the property. The specific properties are not detailed in the spec.

type
enum<string>

A string indicating the data type of the property. Valid values include 'BOOL', 'CURRENCY_NUMBER', 'DATE', 'DATETIME', 'ENUMERATION', 'JSON', 'NUMBER', 'OBJECT_COORDINATES', 'PHONE_NUMBER', 'STRING', and 'TIME_RANGE'.

Available options:
BOOL,
CURRENCY_NUMBER,
DATE,
DATETIME,
ENUMERATION,
JSON,
NUMBER,
OBJECT_COORDINATES,
PHONE_NUMBER,
STRING,
TIME_RANGE
validationRules
object[]

An array of ValidationRule objects that define the validation rules for the property.

Response

successful operation

category
enum<string>
required

Indicates the origin of the property, with possible values being 'HUBSPOT_DEFINED', 'INTEGRATION_DEFINED', or 'USER_DEFINED'.

Available options:
HUBSPOT_DEFINED,
INTEGRATION_DEFINED,
USER_DEFINED
fieldType
enum<string>
required

Defines the field type of the property, with options including 'BOOLEANCHECKBOX', 'CALCULATION_EQUATION', 'CALCULATION_READ_TIME', 'CALCULATION_ROLLUP', 'CALCULATION_SCORE', 'CHECKBOX', 'DATE', 'EMAIL', 'FILE', 'HTML', 'NUMBER', 'PHONE_NUMBER', 'RADIO', 'SELECT', 'TEXT', 'TEXTAREA', 'UNKNOWN', or 'URL'.

Available options:
BOOLEANCHECKBOX,
CALCULATION_EQUATION,
CALCULATION_READ_TIME,
CALCULATION_ROLLUP,
CALCULATION_SCORE,
CHECKBOX,
DATE,
EMAIL,
FILE,
HTML,
NUMBER,
PHONE_NUMBER,
RADIO,
SELECT,
TEXT,
TEXTAREA,
UNKNOWN,
URL
name
string
required

The unique name of the property, represented as a string.

type
enum<string>
required

Specifies the data type of the property, such as 'BOOL', 'CURRENCY_NUMBER', 'DATE', 'DATETIME', 'ENUMERATION', 'JSON', 'NUMBER', 'OBJECT_COORDINATES', 'PHONE_NUMBER', 'STRING', or 'TIME_RANGE'.

Available options:
BOOL,
CURRENCY_NUMBER,
DATE,
DATETIME,
ENUMERATION,
JSON,
NUMBER,
OBJECT_COORDINATES,
PHONE_NUMBER,
STRING,
TIME_RANGE
accessAllowlist
object[]

An array of access control entries defining who can view or edit the property.

archivable
boolean

A boolean indicating if the property can be archived.

archived
boolean

A boolean indicating whether the property is archived.

calculated
boolean

A boolean indicating if the property is calculated.

calculationFormula
string

The formula used for calculating the property's value, if applicable.

createdAt
string<date-time>

The date and time when the property was created, in ISO 8601 date-time format.

createdByUserId
string

The ID of the user who created the property.

currencyPropertyName
string

The name of the currency property associated with this property, if applicable.

dataEntryInstructions
string

Instructions for data entry related to the property, represented as a string.

dataSensitivity
enum<string>

Indicates the sensitivity level of the data, with possible values being 'NONE', 'STANDARD', or 'HIGH'.

Available options:
HIGH,
NONE,
STANDARD
dateDisplayFormat
enum<string>

The format used to display date values, with options such as 'ABSOLUTE', 'ABSOLUTE_WITH_RELATIVE', 'TIME_SINCE', or 'TIME_UNTIL'.

Available options:
ABSOLUTE,
ABSOLUTE_WITH_RELATIVE,
TIME_SINCE,
TIME_UNTIL
defaultValue
string

The default value assigned to the property, represented as a string.

description
string

A string providing a description of the property.

formField
boolean

A boolean indicating if the property is used as a form field.

groupName
string

The name of the group to which the property belongs.

hasUniqueValue
boolean

A boolean indicating if the property must have a unique value across records.

hidden
boolean

A boolean indicating if the property is hidden.

label
string

The label of the property, used for display purposes.

numberDisplayFormat
enum<string>

The format used to display number values, with options such as 'UNFORMATTED', 'FORMATTED', 'CURRENCY', 'PERCENTAGE', 'DURATION', or 'PROBABILITY'.

Available options:
CURRENCY,
DURATION,
FORMATTED,
PERCENTAGE,
PROBABILITY,
UNFORMATTED
optionColors
object[]

An array of colors associated with the property's options, used for visual representation.

options
object[]

An array of options available for the property, applicable if the property type is an enumeration.

optionsSource
enum<string>

The source of the property's options, with possible values being 'OWNER', 'PERSONA', or 'CALL_DISPOSITION'.

Available options:
CALL_DISPOSITION,
OWNER,
PERSONA
readOnlyDefinition
boolean

A boolean indicating if the property's definition is read-only.

readOnlyOptions
boolean

A boolean indicating if the property's options are read-only.

readOnlyValue
boolean

A boolean indicating if the property's value is read-only.

rollupConfig
object
sensitiveDataCategories
string[]

An array of strings representing categories of sensitive data associated with the property.

syncConfig
object
updatedAt
string<date-time>

The date and time when the property was last updated, in ISO 8601 date-time format.

updatedByUserId
string

The ID of the user who last updated the property.

validationRules
object[]

An array of validation rules applied to the property.

Last modified on November 5, 2026