---
schema_version: "1"
id: 4a24947e82a77d8888a9261354c208729d26a701f3d19ed424377db9354cd6f1
title: Setup | Migrate Connected App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/setup_agent_action_migrate_connected_app.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.setup_agent_action_migrate_connected_app.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 97289538f4579a436f46c1f6a43b665e5ad0775db4901230b68aadbc4288b4ff
description: Identifies the configurations of a connected app and creates an identical external client app to replace it. After connected app migration, the connected app remains in the App Manager list but is read only.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Setup | Migrate Connected App

Identifies the configurations of a connected app and creates an identical external client app to replace it. After connected app migration, the connected app remains in the App Manager list but is read only.

### 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>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions with Foundations, or <strong>Agentforce 1</strong> or <strong>Einstein 1</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="col" class="slds-cell-wrap" style="text-align:center;vertical-align:top;" id="d69032e77">User Permissions Needed</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d69032e80">&nbsp;</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d69032e77 d69032e80 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent
              Actions</a>.</td>

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

## Action Details

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

Note This action is no longer being updated. We recommend that you use Setup with Agentforce, which can help with many more administrative tasks and is automatically updated with new functionality. For more information, see [Setup with Agentforce](https://help.salesforce.com/s/articleView?id=xcloud.setup_agentforce_overview.htm&language=en_US).

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col style="width:50%"> <col style="width:50%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">API Name</td><td class="slds-cell-wrap" style="vertical-align:top;">MigrateConnectedApp</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Standard Action</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action</td><td class="slds-cell-wrap" style="vertical-align:top;">Migrate Connected App (migrateConnectedApp)</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Does this action execute one or more prompt templates?</td><td class="slds-cell-wrap" style="vertical-align:top;">No</td></tr></tbody></table>

## Guidelines and Considerations

This agent action calls the Migrate Connected App standard invocable action, which disables the connected app and creates an external client app with identical settings and policies.

To provide a connected app summary, the agent might ask for the connected app's application ID. The application ID is found in the URL for the connected app settings page. It's an alphanumeric string that starts with 06P and appears in the URL after **applicationId%3D**.

Before migrating the connected app to an external client app, you must identify the connected app to migrate. Only local connected apps can be migrated to external client apps. Connected apps that use the OAuth 2.0 Username Password flow can’t be migrated to external client apps, because external client apps don’t support that flow.

#### See Also

- [_User Interface API Developer Guide:_ All Supported Objects](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_all_supported_objects.htm)
- [_Salesforce Help:_ Connected App to External Client App Migration](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_to_external_client_app_migration.htm&type=5&language=en_US)