Update property
Update an existing property for a specified object type in your HubSpot account. This operation allows you to modify the details of a property, such as its label, type, or other configurations. Ensure that the property name and object type ID are correctly specified to successfully update the desired property.
Supported products
Supported products
Scope requirements
Scope requirements
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The unique identifier of the object type whose property you want to update.
The name of the property to update.
Body
An array of PublicAccessAllowlistEntry objects that define the access permissions for the property.
A boolean indicating whether the property is archived.
An object representing the calculation formula for the property. The specific properties are not detailed in the spec.
An object providing instructions for data entry. The specific properties are not detailed in the spec.
An object representing the sensitivity level of the data. The specific properties are not detailed in the spec.
An object indicating the default value for the property. The specific properties are not detailed in the spec.
An object providing a description of the property. The specific properties are not detailed in the spec.
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'.
BOOLEANCHECKBOX, CALCULATION_EQUATION, CALCULATION_READ_TIME, CALCULATION_ROLLUP, CALCULATION_SCORE, CHECKBOX, DATE, EMAIL, FILE, HTML, NUMBER, PHONE_NUMBER, RADIO, SELECT, TEXT, TEXTAREA, UNKNOWN, URL A boolean indicating whether the property is used as a form field.
A string representing the group name to which the property belongs.
A boolean indicating whether the property must have a unique value.
A string representing the display name of the property.
An object representing the option decorators for the property. The specific properties are not detailed in the spec.
An object representing the available options for the property. The specific properties are not detailed in the spec.
An object representing the rollup configuration for the property. The specific properties are not detailed in the spec.
An object representing the synchronization configuration for the property. The specific properties are not detailed in the spec.
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'.
BOOL, CURRENCY_NUMBER, DATE, DATETIME, ENUMERATION, JSON, NUMBER, OBJECT_COORDINATES, PHONE_NUMBER, STRING, TIME_RANGE An array of ValidationRule objects that define the validation rules for the property.
Response
successful operation
Indicates the origin of the property, with possible values being 'HUBSPOT_DEFINED', 'INTEGRATION_DEFINED', or 'USER_DEFINED'.
HUBSPOT_DEFINED, INTEGRATION_DEFINED, USER_DEFINED 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'.
BOOLEANCHECKBOX, CALCULATION_EQUATION, CALCULATION_READ_TIME, CALCULATION_ROLLUP, CALCULATION_SCORE, CHECKBOX, DATE, EMAIL, FILE, HTML, NUMBER, PHONE_NUMBER, RADIO, SELECT, TEXT, TEXTAREA, UNKNOWN, URL The unique name of the property, represented as a string.
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'.
BOOL, CURRENCY_NUMBER, DATE, DATETIME, ENUMERATION, JSON, NUMBER, OBJECT_COORDINATES, PHONE_NUMBER, STRING, TIME_RANGE An array of access control entries defining who can view or edit the property.
A boolean indicating if the property can be archived.
A boolean indicating whether the property is archived.
A boolean indicating if the property is calculated.
The formula used for calculating the property's value, if applicable.
The date and time when the property was created, in ISO 8601 date-time format.
The ID of the user who created the property.
The name of the currency property associated with this property, if applicable.
Instructions for data entry related to the property, represented as a string.
Indicates the sensitivity level of the data, with possible values being 'NONE', 'STANDARD', or 'HIGH'.
HIGH, NONE, STANDARD The format used to display date values, with options such as 'ABSOLUTE', 'ABSOLUTE_WITH_RELATIVE', 'TIME_SINCE', or 'TIME_UNTIL'.
ABSOLUTE, ABSOLUTE_WITH_RELATIVE, TIME_SINCE, TIME_UNTIL The default value assigned to the property, represented as a string.
A string providing a description of the property.
A boolean indicating if the property is used as a form field.
The name of the group to which the property belongs.
A boolean indicating if the property must have a unique value across records.
A boolean indicating if the property is hidden.
The label of the property, used for display purposes.
The format used to display number values, with options such as 'UNFORMATTED', 'FORMATTED', 'CURRENCY', 'PERCENTAGE', 'DURATION', or 'PROBABILITY'.
CURRENCY, DURATION, FORMATTED, PERCENTAGE, PROBABILITY, UNFORMATTED An array of colors associated with the property's options, used for visual representation.
An array of options available for the property, applicable if the property type is an enumeration.
The source of the property's options, with possible values being 'OWNER', 'PERSONA', or 'CALL_DISPOSITION'.
CALL_DISPOSITION, OWNER, PERSONA A boolean indicating if the property's definition is read-only.
A boolean indicating if the property's options are read-only.
A boolean indicating if the property's value is read-only.
An array of strings representing categories of sensitive data associated with the property.
The date and time when the property was last updated, in ISO 8601 date-time format.
The ID of the user who last updated the property.
An array of validation rules applied to the property.