# Contracts API in HubSpot **URL:** \ **Category:** Marketplace Apps\ **Tags:** third-party-apps\ **Created:** [April 9, 2026, 10:46pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175 "2026-04-09T22:46:09Z")\ **Posts on this page:** 12\ **Page:** 1
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 9, 2026, 10:46pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/1 "2026-04-09T22:46:09Z")
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](https://developers.hubspot.com/docs/api-reference/latest/crm/objects/contracts/search/search-contracts#search-for-contracts-using-specified-criteria) ---
**Author:** ![STierney](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stierney/32/186066_2.png) [@STierney](https://community.hubspot.com/u/STierney)\ **Post date:** [April 9, 2026, 11:18pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/2 "2026-04-09T23:18:37Z")
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](https://community.hubspot.com/t5/user/viewprofilepage/user-id/9259), [@zach\_threadint](https://community.hubspot.com/t5/user/viewprofilepage/user-id/324811), and @stefen - do any of you have thoughts on this? Shane, Senior Community Moderator ---
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 10, 2026, 11:56pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/3 "2026-04-10T23:56:55Z")
Hello. Is there any additional support I can get here? this seems like the docs are just wrong or incomplete. ---
**Author:** ![STierney](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stierney/32/186066_2.png) [@STierney](https://community.hubspot.com/u/STierney)\ **Post date:** [April 13, 2026, 7:00pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/4 "2026-04-13T19:00:07Z")
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 ---
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 14, 2026, 2:24am UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/5 "2026-04-14T02:24:11Z")
Thanks. Please let me know what you find! ---
**Author:** ![Mike\_Eastwood](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mike_eastwood/32/70075_2.png) [@Mike\_Eastwood](https://community.hubspot.com/u/Mike_Eastwood)\ **Post date:** [April 9, 2026, 11:31pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/6 "2026-04-09T23:31:05Z")
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](https://www.webalite.com?utm_campaign=community-forum&utm_source=community&utm_content=signature) a Gold HubSpot Partner Agency based in Wellington, New Zealand and the founder of **Portal-iQ** the world’s first automated [HubSpot Portal Audit](https://portal-iq.com?utm_campaign=community-forum&utm_source=community-forum&utm_content=signature) that helps you work smarter with HubSpot. ---
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 10, 2026, 2:26am UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/7 "2026-04-10T02:26:55Z")
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. ---
**Author:** ![Mike\_Eastwood](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mike_eastwood/32/70075_2.png) [@Mike\_Eastwood](https://community.hubspot.com/u/Mike_Eastwood)\ **Post date:** [April 16, 2026, 12:49am UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/8 "2026-04-16T00:49:15Z")
Hi @ToolkitDev This announcement will have some exciting new for you - here’a [post on LinkedIn about **HubSpot Contracts** on LinkedIn.](https://www.linkedin.com/posts/ethan-kopit_for-the-past-nine-months-the-commerce-hub-activity-7449811371694886912-Byfa/) And, here’s the update in the [Spring Spotlight](https://www.hubspot.com/spotlight/) (if you can figure out how to work the page - wtf?). Have fun Mike ---
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 17, 2026, 1:57am UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/9 "2026-04-17T01:57:44Z")
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. ---
**Author:** ![Mike\_Eastwood](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mike_eastwood/32/70075_2.png) [@Mike\_Eastwood](https://community.hubspot.com/u/Mike_Eastwood)\ **Post date:** [April 17, 2026, 7:42pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/10 "2026-04-17T19:42:17Z")
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](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/scopes#app-scope-types). Have fun Mike ---
**Author:** ![STierney](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stierney/32/186066_2.png) [@STierney](https://community.hubspot.com/u/STierney)\ **Post date:** [April 15, 2026, 3:30pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/11 "2026-04-15T15:30:06Z")
Hey @ToolkitDev, Thanks for your patience here! It would appear that [@Mike\_Eastwood](https://community.hubspot.com/t5/user/viewprofilepage/user-id/9259)’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 ---
**Author:** ![ToolkitDev](https://avatars.discourse-cdn.com/v4/letter/t/ee7513/32.png) [@ToolkitDev](https://community.hubspot.com/u/ToolkitDev)\ **Post date:** [April 15, 2026, 11:10pm UTC](https://community.hubspot.com/t/contracts-api-in-hubspot/148175/12 "2026-04-15T23:10:44Z")
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?