1. Prepare and document the current state
- Export the lifecycle/status fields from HubSpot (Contacts/Companies/Deals) and the matching status fields from Xero; save as simple CSVs so you can compare values side by side.
- Note where each value is used: which workflows, invoices, or reporting rely on a particular HubSpot stage or Xero status, and who currently updates them.
- Record owners and touchpoints: who manually changes a stage today, and which automations write back to either system.
2. Map equivalents and decide sources of truth
Work through each pair of values and agree an equivalent (for example: HubSpot "Customer" = Xero "Active"; HubSpot "Closed - Lost" = Xero "Inactive"). Keep mappings short — one line per mapped value — and call out any values that have no clear equivalent.
For each mapped item pick a single source of truth and a sync direction: HubSpot -> Xero, Xero -> HubSpot, or one-way only for specific statuses. Define a simple fallback for unmapped or unexpected values (for example: route to a review queue and set a neutral status like "Needs review"). Note any automations that must be paused while you change the mapping.
3. Test, fix historical mismatches and roll out
- Pick 10–20 representative records (a mix of customers, prospects and problem cases) and run through the sync manually first; confirm the mapping behaves as expected and automations don’t misfire.
- Fix historical mismatches with a two-step bulk approach: export the affected records, map old values to the new canonical values in a spreadsheet, then import back to the system that will be the source of truth for that field.
- Rollout checklist (keep this bite-sized): enable sync for a small segment, monitor changes for 24–48 hours, have an owner ready to revert or pause, communicate the change to the team and update one-page runbooks for who to contact if things look wrong.
- Assign an owner who will own the mapping file, the runbook and the weekly quick-check for the first month; include a short rollback step in case automations start retriggering.
- If you’d like a practical helper, Optira can run a focused afternoon workshop to document values, test sample records and leave you with a simple mapping and rollout plan.