Skip to content

Association limits are written as `maxToObjectIds` per association type (Professional or higher) and read back as `userEnforcedMaxToObjectIds`.

Documented and measured

Checked

Checked October 21, 2026 on a HubSpot developer test account

Area

Tags

associations, limits, max, read-shape

More facts from this area

Take category and typeId from the row the ordered pair's labels call returns, never assume a category: a custom object's unlabeled default (label: null) is USER_DEFINED, a standard pair's is HUBSPOT_DEFINED.Measured
Association label rows carry fromObjectTypeId and toObjectTypeId as null, so the object pair comes from the request path, never from the row.Measured
Up to 50 association labels can be defined per object pair, on Professional or higher.Source pending
GET /crm/associations/{v}/{from}/{to}/labels returns only that direction's typeIds; the reverse order returns different ones, so read both orders of a pair.Measured
Limits tracking (/crm/limits/{v}/associations/records/...) reports only the technical per-pair limit and ignores user-enforced limits; a pair read can return 500 while such a limit is set.Documented and measured

Spriggit uses these facts when it plans changes. See something out of date? Email [email protected]