HSX_E_PROJECT_DEPLOY

HubSpot project deploy failed.

What this error means

`hs-x project deploy` could not select or deploy the requested successful HubSpot build.

When this error stops a command, hs-x exits with code 1. With --json, the failure is reported as a structured error whose code field is HSX_E_PROJECT_DEPLOY — stable to match on in scripts and agents.

Likely causes

  • No project was selected, the requested build does not exist, or that build did not finish successfully
  • The selected HubSpot account is unauthenticated or cannot read or deploy the project
  • The build uses HubSpot release management and must be released instead of deployed directly
  • HubSpot rejected the deploy, returned an unexpected result, or did not reach a terminal state before the timeout

How to fix it

  • Run hs-x project list-builds and retry with an explicit successful build: hs-x project deploy --build <id>
  • Run hs-x project deploy --plan --build <id> to confirm the account, project, and deployment target
  • If the error names release management, run the exact hs project release create --build=<id> command it provides
  • Refresh the selected account with hs account auth, or fix the reported HubSpot error and retry

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.