> For the complete documentation index, see [llms.txt](https://help.getmobly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getmobly.com/help-center/integrations/crm/migrating-from-legacy.md). # 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: 1. **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. 2. **Mobly flips the switch.** Your **Integrations** page now shows the new UI instead of the legacy interface. 3. **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 1. Go to **Integrations** in the left nav. Confirm you see the new card-based layout (CRM, Marketing Automation, etc. as category sections). 2. Click your CRM card. 3. Follow the [Connecting your CRM](/help-center/integrations/crm/connecting.md) steps — connect, then work through Mapping → Qualifiers → Campaigns → Sync mode. 4. Capture a test lead at a test event and confirm it lands in **Reconciliation → Cleared**. 5. 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 * [Connecting your CRM](/help-center/integrations/crm/connecting.md) * [Sync modes](/help-center/integrations/crm/sync-modes.md) * [Reconciliation](/help-center/integrations/crm/reconciliation.md) * [CRM Integrations](/help-center/integrations/crm.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.getmobly.com/help-center/integrations/crm/migrating-from-legacy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.