Create a new app with the Projects-based workflow.
Use hs project create for a New HubSpot Marketplace App
HubSpot's create-app docs describe new developer platform apps as initialized using the HubSpot CLI, with `hs project create` as the setup command to review.
Last source check: 2026-05-24
Citation Summary
Use this page as an unofficial, source-linked planning reference for create a new app with the projects-based workflow. The key takeaway is: HubSpot's create-app docs describe new developer platform apps as initialized using the HubSpot CLI, with `hs project create` as the setup command to review.
Suggested citation: Projects App Guide, "Use hs project create for a New HubSpot Marketplace App," last source check 2026-05-24, https://projectsappguide.com/hs-project-create-marketplace-app
Answer Snapshot
- Short Answer
- `hs project create` is the Projects CLI path to review when creating a new HubSpot developer platform app.
- Applies To
- Teams creating a new public or Marketplace app rather than modernizing an existing app.
- Verify
- Open the create-app docs, project commands docs, and Marketplace listing docs before upload or submission.
- Boundary
- Do not use new app creation guidance as a substitute for an existing app migration plan.
Independent educational guide. Not affiliated with, endorsed by, or sponsored by HubSpot. Verify critical commands and platform behavior against official HubSpot documentation before deploying.
When this path fits
This page is for teams creating a new public or Marketplace app, especially after the legacy public app creation path is no longer available for their developer account. HubSpot's create-app documentation points new developer platform apps toward the CLI-based Projects workflow, with `hs project create` as the setup command to review.
This is not the page to use when you only need to maintain an existing legacy public app. It is also not enough for a private app migration decision. In those cases, classify the app first and follow the relevant migration or private app docs.
The output you want before a developer starts is a short creation brief: target developer account, app name, authentication type, OAuth redirect URLs, scopes, feature list, Marketplace intent, and who owns listing/support/privacy materials.
Command flow to verify
`hs project create` starts the project creation flow to review in the official docs. After setup, teams commonly review project commands for local development, upload, and opening the project in HubSpot.
Treat this flow as a source-controlled project setup, not a one-time UI action. Files such as `hsproject.json` and app configuration files become part of the review surface for CI, code review, and handoff.
Before upload, confirm the target account and install/test flow. For public or Marketplace apps, also check listing requirements early so technical build work does not outpace support, privacy, and review-readiness work.
Marketplace readiness notes
A Projects CLI app can still fail a launch workflow if Marketplace materials are unfinished. Assign owners for support contact, privacy policy, testing instructions, screenshots or assets, and install-flow evidence.
Keep the product language precise with clients: this checklist helps prepare a reviewable workflow, but it does not guarantee Marketplace approval or certify compliance. Marketplace requirements must be checked against HubSpot's current listing documentation before submission.
If the app includes classic CRM cards, create a separate app-card modernization task. The CRM card deadline is not the same as the May/June legacy public app creation sunset.
Checklist
- Confirm the app is public/Marketplace scoped.
- Verify `app-hsmeta.json` before upload.
- Test install flow in a developer or test account.
Claim / Source Map
These are the main claims this page relies on. Re-open the linked official HubSpot source before production-affecting commands, uploads, submissions, or client delivery.
| Claim | Official source |
|---|---|
| New developer platform apps are created through the HubSpot CLI workflow. | Create a new app using the CLI |
| `hs project create` is a project command to verify for new app creation. | HubSpot CLI project commands |
| Marketplace submission has separate listing requirements and review materials. | Listing your app |
FAQ
When should I use hs project create?
Use it as the official path to review when creating a new Projects-based app. Do not use it as a substitute for planning an existing app migration.
Is a Marketplace app automatically ready after project creation?
No. Marketplace readiness also requires support, privacy, testing, install-flow, listing, and review materials checked against current HubSpot requirements.
Use the agent-ready skill workflow
Give your coding agent a source-linked workflow for classifying apps and generating a migration handoff.
Independent educational product. Gumroad checkout opens in a separate page; no official affiliation or guarantee is implied.