hs-xdocs
Reference · Error codes

HSX_E_DEPLOY_HUBSPOT_AUTH

HubSpot deploy account is not ready.

What this error means

A native HubSpot project could not resolve an authenticated developer account for its direct deploy.

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

Likely causes

  • The requested --account name or id is not present in the HubSpot CLI config
  • No account is selected by the nearest .hsaccount file or hs account use
  • The selected developer account has no usable personal access key

How to fix it

  • Run hs account list and hs account use <account> to select the intended developer account
  • Run hs account auth to refresh its authentication
  • Or pass --account <name-or-id> for this deploy

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