Read custom object limits

curl --request GET \
  --url https://api.hubapi.com/crm/v3/limits/custom-object-types \
  --header 'Authorization: Bearer <token>'

{
  "limit": 123,
  "percentage": 123,
  "usage": 123
}

GET

crm

limits

custom-object-types

Read custom object limits

curl --request GET \
  --url https://api.hubapi.com/crm/v3/limits/custom-object-types \
  --header 'Authorization: Bearer <token>'

{
  "limit": 123,
  "percentage": 123,
  "usage": 123
}

Supported products

Requires one of the following products or higher.

Marketing Hub -Free

Sales Hub -Free

Service Hub -Free

Content Hub -Free

Data Hub -Free

Required Scopes

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

successful operation

limit

integer<int64>

required

The maximum number of custom objects allowed.

percentage

number

required

The percentage of the custom object limit that is currently used.

usage

integer<int64>

required

The current number of custom objects used.

Last modified on December 16, 2025