curl --request GET \
--url https://api.hubapi.com/crm/properties/2025-09/{objectType} \
--header 'Authorization: Bearer <token>'{
"results": [
{
"displayOrder": 2,
"fieldType": "select",
"formField": true,
"groupName": "contactinformation",
"hasUniqueValue": false,
"hidden": false,
"label": "My Contact Property",
"modificationMetadata": {
"archivable": true,
"readOnlyDefinition": false,
"readOnlyOptions": false,
"readOnlyValue": false
},
"name": "my_contact_property",
"options": [
{
"description": "Choice number one",
"displayOrder": 1,
"hidden": false,
"label": "Option A",
"value": "A"
},
{
"description": "Choice number two",
"displayOrder": 2,
"hidden": false,
"label": "Option B",
"value": "B"
}
],
"type": "enumeration"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
},
"prev": {
"before": "<string>",
"link": "<string>"
}
}
}Read all properties
Read all existing properties for the specified object type and HubSpot account.
curl --request GET \
--url https://api.hubapi.com/crm/properties/2025-09/{objectType} \
--header 'Authorization: Bearer <token>'{
"results": [
{
"displayOrder": 2,
"fieldType": "select",
"formField": true,
"groupName": "contactinformation",
"hasUniqueValue": false,
"hidden": false,
"label": "My Contact Property",
"modificationMetadata": {
"archivable": true,
"readOnlyDefinition": false,
"readOnlyOptions": false,
"readOnlyValue": false
},
"name": "my_contact_property",
"options": [
{
"description": "Choice number one",
"displayOrder": 1,
"hidden": false,
"label": "Option A",
"value": "A"
},
{
"description": "Choice number two",
"displayOrder": 2,
"hidden": false,
"label": "Option B",
"value": "B"
}
],
"type": "enumeration"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
},
"prev": {
"before": "<string>",
"link": "<string>"
}
}
}Supported products
Supported products
Marketing Hub -Free
Sales Hub -Free
Service Hub -Free
Content Hub -StarterRequired Scopes
Required Scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
Query Parameters
Whether to return only results that have been archived.
highly_sensitive, non_sensitive, sensitive Response
successful operation
Show child attributes
Show child attributes
A description of the property that will be shown as help text in HubSpot.
Controls how the property appears in HubSpot.
The name of the property group the property belongs to.
A human-readable property label that will be shown in HubSpot.
The internal property name, which must be used when referencing the property via the API.
A list of valid options for the property. This field is required for enumerated properties, but will be empty for other property types.
Show child attributes
Show child attributes
If true, the option will not be shown in forms, bots, or meeting scheduling pages. Supported for contact, company, ticket, and custom object enumeration properties.
A human-readable option label that will be shown in HubSpot.
The internal value of the option, which must be used when setting the property value through the API.
A description of the option.
Options are displayed in order starting with the lowest positive integer value. Values of -1 will cause the option to be displayed after any positive values.
The property data type.
Whether or not the property is archived.
When the property was archived.
For default properties, true indicates that the property is calculated by a HubSpot process. It has no effect for custom properties.
Represents a formula that is used to compute a calculated property.
The timestamp when the property was created, in ISO 8601 format.
The internal user ID of the user who created the property in HubSpot. This field may not exist if the property was created outside of HubSpot.
Indicates the sensitivity level of the property, such as "non_sensitive", "sensitive", or "highly_sensitive".
highly_sensitive, non_sensitive, sensitive absolute, absolute_with_relative, time_since, time_until Properties are shown in order, starting with the lowest positive integer value.
For default properties, true indicates that the options are stored externally to the property settings.
Whether or not the property can be used in a HubSpot form.
Whether or not the property's value must be unique. Once set, this can't be changed.
If true, the option will not be shown in forms, bots, or meeting scheduling pages. Supported for contact, company, ticket, and custom object enumeration properties.
This will be true for default object properties built into HubSpot.
If this property is related to other object(s), they'll be listed here.
When sensitiveData is true, lists the type of sensitive data contained in the property (e.g., "HIPAA").
Whether or not the property will display the currency symbol set in the account settings.
The timestamp when the property was last updated, in ISO 8601 format.
The internal user ID of the user who updated the property in HubSpot. This field may not exist if the property was updated outside of HubSpot.
Show child attributes
Show child attributes
Was this page helpful?