Reference · Error codes

HSX_E_LINK_REQUIRED

Command requires a linked HS-X account.

What this error means

This command (promote, drift, audit, etc.) operates on control-plane state that only exists once the project is linked to an HS-X account.

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

Likely causes

  • Running an HS-X-managed command unlinked
  • Bearer session expired or cleared

How to fix it

  • Run hs-x link to attach this Cloudflare + HubSpot Developer account pair to an HS-X account
  • Or pass --control-plane-url <url> explicitly if you are operating against a specific control plane for dev/test

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