We are introducing a new field called fieldLevelPermission to the v1 CRM Properties API. 

What's changing?

The new field is called fieldLevelPermission, and only appears on the response returned by the v1 CRM Properties APIs. It represents a HubSpots user's permission level to access or modify a HubSpot property on a CRM record. More details on field level permission in general are linked here. 

The field will look like the example below when it’s returned, and will always contain an empty value.

fieldLevelPermission: ""

The field is read-only, cannot be modified and will appear in the response for the following CRM endpoints: 

GET properties/v1/{objectType}/groups
Get Contact Property Groups
Get Company Property Groups
Get Deal Property Groups

GET properties/v1/{objectType}/properties
Get All Contact Properties
Get All Company Properties
Get All Deal Properties

When is this happening?

This change will be deployed on November 3rd 2021. 

If you have any questions or comments, please join the conversation in the developer community forum.