---
schema_version: "1"
id: 30059ea84bb7dcb17e5b6e686781983e78af6bf6b6d28166b6f053cba1e06431
title: Migrate a Local Connected App to an External Client App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/migrate_connected_app_to_external_client_app.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.migrate_connected_app_to_external_client_app.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a3ed135d8d7782fcc581fd53b678be111aadb68f53a860a2bfb38f11c10c8c26
description: Use the automated process to create a local external client app that replaces your existing local connected app. After migration, the old connected app remains as a read-only version in App Manager. External client apps created through migration are secure.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Migrate a Local Connected App to an External Client App

Use the automated process to create a local external client app that replaces your existing local connected app. After migration, the old connected app remains as a read-only version in App Manager. External client apps created through migration are secure.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Professional</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d5638e68">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d5638e68 ">To create local External Client Apps</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d5638e68 ">Create, edit, and delete External Client Apps</td>

          </tr>
        </tbody>
      </table>

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_tip.png)

Tip Instead of completing this task manually, get help from Setup with Agentforce. For example, tell the Setup agent, “Migrate the Acme connected app to an external client app.” For more information, see [Identity Management in Setup with Agentforce](https://help.salesforce.com/s/articleView?id=xcloud.setup_agentforce_identity.htm&language=en_US).

1. From Setup, in the Quick Find box, enter App Manager, and then select **App Manager**.
2. Open the connected app by clicking the name.
    
    If the connected app is eligible for migration, the **Migrate to External Client App** button is available.
3. Click **Migrate to External Client App**.
4. Confirm that the app is local and that it doesn’t use the username-password flow.
5. Click **Migrate**.
    
    A window opens with a link to the new external client app.

After an external client app is created from a connected app, the connected app remains as a read-only version. After it's created, make all changes to the new external client app. Changes made to the external client app don’t change the read-only connected app that created it. If you delete the external client app, then the connected app becomes active again. However, the settings and policies remain as they were when the external client app was created.

After migration, the migrated connected app doesn't show up in Notification Delivery Settings or the Briefcase connected app assignment.