Reference · Error codes

HSX_E_API_NO_CONTROL_PLANE

No HS-X control plane configured.

What this error means

`hs-x api` (HS-X target) had no base URL to call.

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

Likely causes

  • HSX_CONTROL_PLANE_URL not set
  • --base-url not passed

How to fix it

  • Set HSX_CONTROL_PLANE_URL
  • Or use hs-x api hubspot <path> to call HubSpot instead

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