Skip to content

Conversation

@caiopizzol
Copy link
Collaborator

Description

Update HubSpot provider guide to reflect HubSpot's 2025 developer platform changes:

  • Add "Before You Get Started" section with prerequisites
  • Update Method 2 to use Public Apps (not Private Apps) for OAuth support
  • Add Method 3 for CLI-based Project Apps with intro explaining when to use it
  • Fix formatting and language consistency throughout

Notes

image

Screenshot

image

@linear
Copy link

linear bot commented Dec 17, 2025

- Enter your project name: **your-project-name**
- Choose where to create the project: **your-desired-path**
- Choose what to include in your project: **App**
- Choose how to distribute your application: **Privately**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What are the other options that are not "Privately" and what do they mean?

Our builders would want their HubSpot apps to connect with their customer's HubSpot instances, not just their own, does "Privately" prevent them from doing so?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good question!

There are two distribution options when using HubSpot projects:

  • Privately - Allows OAuth-based installation to multiple customer accounts (up to 10 customers, or
    100 for Solution Partners).
  • Marketplace - For apps intended to be listed on the HubSpot App Marketplace (limited to 25 installs
    until listed).

So actually - we shouldn't recommend using Method 3 (for Ampersand use). More on new distribution limits: https://developers.hubspot.com/changelog/new-marketplace-distribution-app-install-limits

@laurenzlong laurenzlong merged commit a244c85 into main Dec 24, 2025
3 checks passed
@laurenzlong laurenzlong deleted the caiopizzol/con-2643-update-hubspot-provider-guide-to-include-instructions-on-new branch December 24, 2025 00:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants