hs-xdocs
Reference · Error codes

HSX_E_DIRECT_HUBSPOT_ACCOUNT_REQUIRED

HubSpot developer account is required.

What this error means

No unambiguous developer account could be selected for a direct command.

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

Likely causes

  • No explicit account, .hsaccount override, selected default, or sole account exists

How to fix it

  • Run hs account use <account> or pass --account <name-or-id>

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