Reference · Error codes

HSX_E_DEPLOY_SCHEMA_APPLY

Portal schema apply failed.

What this error means

The `--apply-schema` leg of the deploy could not apply the planned portal schema changes. Actions that applied before the failure are listed in the output; re-running after the fix is safe (already-applied properties plan as no-ops).

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

Likely causes

  • HubSpot rejected a property create/alter (the error detail carries the response)
  • --apply-schema was combined with a fixture schema or run without --portal-schema-live/--local-hubspot-schema
  • The portal schema plan itself has errors (apply refuses to run on a plan with ERROR lines)

How to fix it

  • Read the failed action and HubSpot detail in the error output
  • Preview the plan first: hs-x deploy --plan --portal-schema-live

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