HSX_E_PROJECT_UPLOAD

HubSpot project upload failed.

What this error means

`hs-x project upload` could not create a successful HubSpot build or finish its configured auto-deploy.

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

Likely causes

The local project descriptor, selected profile, component metadata, or source archive could not be read or translated
The selected HubSpot account is unauthenticated, cannot access the project, or cannot create a missing project
HubSpot rejected the upload, the build failed or timed out, or the configured auto-deploy did not complete

How to fix it

Run hs-x project upload --plan to confirm the selected account, project, and upload options
Read the skipped-component, build-status, and correlation details in the command output, then fix the reported source or authentication issue
Pass --force only when creating the missing project or accepting skipped component metadata is intentional
Use --skip-auto-deploy to create only the build, then deploy it explicitly after reviewing the result

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