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