HubSpot CI/CD & DevOps Integration — Sources

Official HubSpot GitHub Actions

• hubspot-project-actions (current, recommended): https://github.com/HubSpot/hubspot-project-actions
• Bundles project-upload, project-deploy, project-validate actions for HubSpot Projects.
• hubspot-project-upload-action (DEPRECATED — use hubspot-project-actions): https://github.com/HubSpot/hubspot-project-upload-action
• hubspot-cms-deploy-action (CMS themes/modules): https://github.com/HubSpot/hubspot-cms-deploy-action
• Marketplace - HubSpot Project Action: https://github.com/marketplace/actions/hubspot-project-action
• Marketplace - HubSpot CMS Deploy: https://github.com/marketplace/actions/hubspot-cms-deploy

Official HubSpot Docs

• Continuous integration with GitHub Actions (dev environment): https://developers.hubspot.com/docs/cms/start-building/introduction/developer-environment/github-integration
• GitHub integration guide: https://developers.hubspot.com/docs/cms/guides/github-integration
• Install the HubSpot CLI: https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli

Key CI/CD patterns

• Use env vars in CI rather than committing hubspot.config.yml: set HUBSPOT_ACCOUNT_ID and HUBSPOT_PERSONAL_ACCESS_KEY, then hs project upload --use-env.
• Store personal access key as a GitHub secret; account id as a variable.
• Workflow file at .github/workflows/main.yml; supports separate staging branch/account deploys.
• Auto-deploy: if enabled, project-upload also deploys the build.

Community / third-party

• Modern HubSpot CMS Development Flow With CI and GIT (Netguru): https://www.netguru.com/blog/modern-hubspot-cms-development-flow-with-ci-and-git
• Community: Deploy a HubSpot App via CI/CD: https://community.hubspot.com/t5/APIs-Integrations/How-can-I-let-CICD-to-deploy-an-app-to-Hubspot/m-p/1249905
• cms-theme-boilerplate (starter repo): https://github.com/HubSpot/cms-theme-boilerplate