Reference · Error codes

HSX_E_DEV_SESSION_REGISTER

Dev session register failed.

What this error means

HubSpot did not return a sessionId from `dev-sessions/register`.

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

Likely causes

  • HubSpot API changed shape
  • Auth scope insufficient

How to fix it

  • Re-run with --debug to inspect
  • Run hs-x doctor to verify PAK validity

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