HubSpot · api · fg-0389

HubSpot lifecyclestage will not move back to an earlier stage through the API

lifecyclestage keeps the later value after an API update

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

Lifecycle stage only moves forward when set by imports, forms, workflows, or the API. Moving it backward requires clearing the value first.

Fix

Send two updates: first set lifecyclestage to an empty string, then set the earlier stage. Read the record back to confirm.

Apply

await patch({ properties: { lifecyclestage: '' } }); await patch({ properties: { lifecyclestage: 'lead' } });

Affects: HubSpot CRM contacts and companies, default lifecyclestage property, as of 2026-10

Sources

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp