Migrating from the legacy CRM integration
Mobly is replacing its older direct-auth CRM integrations with a new integration platform — unified, vendor-neutral, and the home for everything new. If you're still on the legacy integration, you should plan to migrate. New features (Reconciliation, the unified Mapping editor, multi-object syncing, the Qualifiers tab, per-campaign sync) only ship to the new platform, and any new sync error handling lands there too.
Why migrate
The new platform gives you:
Reconciliation tab — see exactly which leads didn't sync to your CRM and why, with self-serve fixes for most error categories. The legacy integration didn't surface sync errors with this clarity.
Unified mapping UI — every Mobly field's CRM destination is configured in one place per object (Lead, Contact, Company), with Set Defaults to pre-populate Mobly's recommendations. Legacy used separate per-object panels and per-CRM auth screens.
Auto-save mappings — changes save immediately as you make them. The legacy integration could lose mappings if you switched tabs before saving.
Sync modes — toggle between Automatic and Manual sync per integration. Legacy didn't expose this.
Better error categorization — sync errors are grouped by root cause, with deep links from the product directly to the right help section.
Faster troubleshooting — when an issue does come up, Mobly support and engineering can debug the new platform faster than the legacy stack. (One reason every "something's broken" call ends with "let's get you on the new platform.")
The legacy integration is in maintenance-only mode — no new features, security and compliance fixes only.
How migration works
You can't flip yourself to the new platform — it's a toggle on Mobly's side, per organization. To migrate:
Ask your CSM to enable the new integration platform for your org. This is fast (a config change). Schedule it for a low-traffic window if you're worried about disruption — typically a Friday afternoon or between events works well.
Mobly flips the switch. Your Integrations page now shows the new UI instead of the legacy interface.
You reconnect and reconfigure — see the steps below.
There's no auto-migration of legacy mappings. The new platform uses a different mapping system, so you'll set up mappings fresh. Plan for ~30 minutes of reconfiguration if you have a complex setup, less if your mappings are straightforward.
What carries over and what doesn't
Carries over:
Leads already in your CRM stay there — the new platform doesn't touch existing records on the CRM side
Your CRM account itself (you'll re-authenticate, but no need to set up a new CRM user)
Mobly's lead history (every lead Mobly has captured is preserved)
Needs to be redone in the new platform:
CRM authentication — re-authorize through the new Connect tab
Field mappings — set up under the Mapping tab (use Set Defaults for a fast start)
Qualifier mappings — set up under the Qualifiers tab
Campaign mappings — set up under the Campaigns tab if you sync per-event campaigns
Sync mode — defaults to Automatic; switch to Manual on the Connect tab if needed
Reconfiguration steps after the switch
Go to Integrations in the left nav. Confirm you see the new card-based layout (CRM, Marketing Automation, etc. as category sections).
Click your CRM card.
Follow the Connecting your CRM steps — connect, then work through Mapping → Qualifiers → Campaigns → Sync mode.
Capture a test lead at a test event and confirm it lands in Reconciliation → Cleared.
Once you're confident, you're done. The legacy code path is no longer used for your org.
What if I don't migrate?
The legacy integration keeps working until Mobly fully sunsets it. Mobly will give advance notice before the cutoff. Once retired, organizations still on legacy lose access to CRM sync entirely until they migrate.
You also miss every feature that's only on the new platform — the most painful of which is Reconciliation. Without it, sync errors just fail silently and your CSM has to dig into logs to figure out why a lead didn't make it.
What about Marketing Automation? Slack? Other connections?
This article focuses on CRM migration since that's where most legacy integrations live. If you also have Marketing Automation or other connections set up, your CSM will sequence the migration for each one. The reconfiguration pattern is the same across all categories.
Related articles
Last updated
Was this helpful?