Prompt
HubSpot App Marketplace integration development
Latest observation
Sure — if you’re developing a HubSpot App Marketplace integration, here’s a practical high-level guide to get started.
1) Understand what you’re building
A HubSpot app marketplace integration typically means one or more of these:
- OAuth app that users install into their HubSpot account
- Public app listed in the HubSpot App Marketplace
- Private app for internal use only
- Embedded app / UI extension inside HubSpot
- Backend integration that syncs data with HubSpot CRM objects, contacts, deals, tickets, etc.
2) Decide the integration type
Common options:
Public App Marketplace listing
Use this if you want other HubSpot customers to install your app.
You’ll need:
- OAuth 2.0 authorization
- Scopes for required HubSpot APIs
- App review/approval
- Marketplace listing details
- Privacy policy, support info, and branding assets
Private App
Use this if only your own HubSpot portal needs access.
- Simpler setup
- No marketplace listing
- Uses a static access token
- Not suitable for customer-facing distribution
Embedded / UI extension
If you want your app to show inside HubSpot pages:
- Build UI cards/extensions
- Use HubSpot’s UI extension framework
- Often paired with backend APIs
3) Set up your HubSpot developer account
Steps:
- Create or sign into a HubSpot Developer Account
- Create a new app in the developer portal
- Configure:
- Redirect URLs
- OAuth scopes
- Webhook subscriptions
- Install URL / app settings if needed
4) Implement OAuth
For marketplace apps, OAuth is required.
Typical flow:
- User clicks “Connect HubSpot”
- Redirect to HubSpot authorization URL
- User approves scopes
- HubSpot redirects back with
code - Exchange
codefor access/refresh tokens - Store tokens securely
- Refresh tokens as needed
Important:
- Never expose client secret in frontend code
- Store tokens encrypted
- Handle revoked consent gracefully
5) Use HubSpot APIs
Depending on your use case, you may use:
- CRM API (contacts, companies, deals, tickets, custom objects)
- Engagements / notes / tasks
- Timeline events
- Webhooks
- Search API
- Associations API
- Forms API
- Files API
Common patterns:
- Sync HubSpot records to your app
- Push updates back into HubSpot
- Use webhooks for near real-time changes
- Use polling only if webhooks aren’t enough
6) Build your backend
Recommended architecture:
- Frontend: React/Vue/Next.js or similar
- Backend: Node.js, Python, Java, .NET, etc.
- Database: store tenant/account mapping and encrypted tokens
- Queue/worker: handle sync jobs, retries, batch imports
- Webhook endpoint: receive HubSpot events
Key backend responsibilities:
- Token management
- Tenant isolation
- Rate limit handling
- Error retries
- Data mapping between your system and HubSpot objects
7) Handle HubSpot-specific requirements
Things to pay attention to:
- API limits and rate limiting
- Pagination
- Association IDs
- Custom properties
- Portal/account-specific configuration
- Multi-tenant support
- Webhook signature verification if applicable
- GDPR / data deletion support
- Uninstall handling
8) Prepare for marketplace review
If publishing publicly, HubSpot may review:
- OAuth implementation
- Scope usage
- Security practices
- UX/branding
- Documentation
- Data handling/privacy policy
- Support/contact information
Make sure you have:
- Clear setup instructions
- Terms of service / privacy policy
- In-app help or documentation
- Testing instructions for reviewers
9) Test thoroughly
Test with:
- A developer portal test account
- A sandbox or test HubSpot account
- Multiple portals/tenants
- Scope approval/denial cases
- Token refresh
- Revoked access
- Webhook retries
- Data sync conflicts
10) Useful implementation checklist
- Create HubSpot developer app
- Configure OAuth redirect URIs
- Define scopes minimally
- Implement auth code flow
- Store access/refresh tokens securely
- Build API client wrapper
- Add webhook receiver
- Handle rate limits and retries
- Add uninstall and deauthorization handling
- Document setup and support steps
- Submit for marketplace review
11) What I can help you with next
I can help you with any of these:
- Designing the integration architecture
- Choosing the right HubSpot APIs/scopes
- Building OAuth flow examples
- Writing Node.js/Python/Java code for HubSpot auth and API calls
- Creating webhook handlers
- Preparing a marketplace listing
- Debugging install/auth issues
If you want, I can provide a step-by-step HubSpot OAuth integration example in your preferred language.