Based on my research, the Contracts API endpoints do exist in HubSpot (e.g., GET /crm/v2026-03/objects/contracts), but the OpenAPI spec does not define any specific OAuth scopes for contracts, and no crm.objects.contracts.read or similar scope appears in the security schemes.
When I hit the `GET /crm/v3/objects/contracts?limit=1` or `GET /crm/objects/2026-03/contracts?limit=1` endpoints i see error message “The scope needed for this API call isn’t available for public use. If you have questions, contact support or post in our developer forum.”
Why is this one api endpoint misdocumented or unavailable?
Source: https://developers.hubspot.com/docs/api-reference/latest/crm/objects/contracts/search/search-contracts#search-for-contracts-using-specified-criteria
Hey @ToolkitDev,
Thanks for posting in the Community!
I’d like to tag in a few Community experts who may have better insight on why this is occuring. @Mike_Eastwood, @zach_threadint, and @stefen - do any of you have thoughts on this?
Shane, Senior Community Moderator
Hello. Is there any additional support I can get here? this seems like the docs are just wrong or incomplete.
Hey @ToolkitDev,
Thanks for following up here!
I’m currently attempting to cross-reference our internal team on these docs to see what insight I may be able to gather and provide to you. I’ll be sure to update you once I hear back!
Shane, Senior Community Moderator
Thanks. Please let me know what you find!
Ooo, good spotting @ToolkitDev
In the past I’ve seen the API Docs appear before the API Endpoint have been launched.
Last time I saw the endpoint I wanted I tried guessing scopes (worth a try, huh?) but I could never get access.
My assumption is there is a closed beta, or alpha release, so you could try connecting with the Product Owner at HubSpot.
Please let me know if you find out more!
Mike
p.s. thank you for the mention @STierney
Here to learn more about HubSpot and share my HubSpot Knowledge. I’m the founder of Webalite a Gold HubSpot Partner Agency based in Wellington, New Zealand and the founder of Portal-iQ the world’s first automated HubSpot Portal Audit that helps you work smarter with HubSpot.
Thank you. Could you clarify who/what a Product Owner is? It seems odd to me that in the Quotes → Deals → Contracts → Invoices pipeline I can pull everything else from the API and have the Oauth Scopes to do so, but not Contracts. Am I missing something? Its confusing to me that no one else has hit this issue (from what I can see on the forums). Seems like a core product.
Hi @ToolkitDev
This announcement will have some exciting new for you - here’a post on LinkedIn about HubSpot Contracts on LinkedIn.
And, here’s the update in the Spring Spotlight (if you can figure out how to work the page - wtf?).
Have fun
Mike
Thank you. This looks promising, but I’m still not seeing any oauth scopes named “contracts” in my dev account, or any change in the docs.
Hey @ToolkitDev
If you are building a Private App the scopes (crm.objects.contracts.read) probably will not show up unless you have a Commerce Hub Seat (if the scopes are even live yet).
If you are building a Public App you will need to be careful with where you add the scopes: Required, Conditionally Required, Optional more info on App Scope Types here.
Have fun
Mike
Hey @ToolkitDev,
Thanks for your patience here!
It would appear that @Mike_Eastwood’s suggestion (that the docs were updated ahead of the release) is correct. While we don’t currently have a timeline to share regarding when this will be available, the fact that it’s documented would imply that we expect this to be available at some point.
I do apologize for the confusion, and I’m hoping that this is released sooner rather than later! But I hope this at least clarifies that we don’t expect this to be accessible publicly as of yet, and now the team is aware of the misalignment within our documentation.
Shane, Senior Community Moderator
Ok, thank you. This is still quite confusing. Is there then no way to fetch Contracts from the HubSpot API right now? This seems like HubSpot’s main concept, so I’m wondering how everyone else is using HubSpot’s API if this is truly not available. Is there no other way to access the Contracts?