Get all contacts properties | Contacts properties API

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Headers

Products:

Marketing & CRM

Required Scope:

Contact properties are fields that store information about a contact record. This endpoint will return the definitions for all of the contact properties in a HubSpot account, including all default properties and any custom contact properties that have been created for the account.

Required Parameters	How to use	Description
OAuth Access Token or API Key	Authorization: Bearer {token} header or hapikey={key} query parameter.	Used to authenticate the request. Please see this page for more details about authentication.

Example URL: https://api.hubapi.com/properties/v1/contacts/properties?hapikey=demo

Example URL: https://api.hubapi.com/properties/v1/contacts/properties?hapikey=demo Example JSON output: [ { "name": "example_property_name", "label": "Example Property Name", "description": "Example Description of the property", "groupName": "contactinformation", "type": "string", "fieldType": "text", "options": [ ], "deleted": false, "displayOrder": -1, "readOnlyValue": false, "readOnlyDefinition": false, "hidden": false, "mutableDefinitionNotDeletable": false, "favorited": false, "favoritedOrder": -1, "calculated": false, "externalOptions": false, "displayMode": "current_value", "formField": true }, { "name": "first_deal_created_date", "label": "First Deal Created Date", "description": "The date the first deal for a contact was created. This is automatically set by HubSpot and can be used for segmentation and reporting.", "groupName": "contactinformation", "type": "datetime", "fieldType": "text", "options": [ ], "displayOrder": -1, "readOnlyValue": true, "readOnlyDefinition": true, "hidden": false, "mutableDefinitionNotDeletable": true, "favorited": false, "favoritedOrder": -1, "calculated": false, "externalOptions": false, "displayMode": "current_value", "hubspotDefined": true, "formField": false }, { "name": "hs_email_sends_since_last_engagement", "label": "Sends Since Last Engagement", "description": "This property tracks how many marketing emails have been sent to a contact since they last engaged with one.", "groupName": "emailinformation", "type": "number", "fieldType": "text", "options": [ ], "displayOrder": -1, "readOnlyValue": true, "readOnlyDefinition": true, "hidden": false, "mutableDefinitionNotDeletable": true, "favorited": false, "favoritedOrder": -1, "calculated": false, "externalOptions": false, "displayMode": "current_value", "hubspotDefined": true, "formField": false }, //... ]