hs-xdocs
Reference · Error codes

HSX_E_DEPLOY_HUBSPOT

HubSpot direct deploy failed.

What this error means

HubSpot rejected or could not complete a native project upload, build, or deployment.

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_DEPLOY_HUBSPOT — stable to match on in scripts and agents.

Likely causes

  • The project archive or component configuration failed HubSpot validation
  • The selected account lacks access, authentication, or a required scope
  • HubSpot returned a transient project, build, or deploy API failure

How to fix it

  • Read the HubSpot status, validation message, and correlation id in the command output
  • Run hs-x deploy --plan to confirm the selected project and account
  • Fix the reported component or authentication issue 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.

Keep going