There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Get all contact properties

Last updated May 12, 2023

GET /properties/v1/contacts/properties

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:

Contact properties are fields that store information about a contact record. This endpoint is used to retrieve all contact properties in a HubSpot account, including all default properties and any custom contact properties that have been created for the account.

Use case for this endpoint: A synchronizing integration could use this method to understand what kind of information it needs to stay up-to-date.

Required parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.

Example URL: