---
schema_version: "1"
id: 9e7ab98d114371d1856ee4ae1062e90d4a816df09b8c7c95a6d44ea3eee73633
title: Install a Connected App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/connected_app_how_to_install.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.connected_app_how_to_install.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a1e5d29fe8ff9acc718383f5136157083ab698e8498a74312b831338b8eb3594
description: You install a connected app by installing a managed package that includes the connected app as a component. For example, ISVs package connected apps to make them available on AppExchange. You can also install an OAuth connected app from the Connected Apps OAuth Usage page. This page lists all OAuth connected apps that users in your org are connecting to currently—including apps that developers created in other Salesforce orgs.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Install a Connected App

You install a connected app by installing a managed package that includes the connected app as a component. For example, ISVs package connected apps to make them available on AppExchange. You can also install an OAuth connected app from the Connected Apps OAuth Usage page. This page lists all OAuth connected apps that users in your org are connecting to currently—including apps that developers created in other Salesforce orgs.

### 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: both Salesforce Classic and Lightning Experience</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Connected Apps can be created in: <strong>Group</strong>, <strong>Essentials</strong>,
                <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and
                <strong>Developer</strong> Editions
              </p>
              <p style="margin-bottom:0;">Connected Apps can be installed in: All
                editions</p>
            </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="d76723e85">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To read, create, update, or delete connected apps:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To update all fields except Profiles, Permission Sets, and Service Provider
              SAML Attributes:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To update Profiles, Permission Sets, and Service Provider SAML
              Attributes:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">Customize Application AND Modify All Data AND Manage Profiles and Permission
              Sets</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To rotate the consumer key and consumer secret:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">Allow consumer key and secret rotation</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To install and uninstall connected apps:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">To install and uninstall packaged connected apps:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d76723e85 ">
              <p>Download AppExchange Packages AND Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All
                Data OR Manage Connected Apps</p>
            </td>

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

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

Note Connected apps creation is restricted as of Spring ‘26. You can continue to use existing connected apps during and after Spring ‘26. However, we recommend using [external client apps](https://help.salesforce.com/s/articleView?id=xcloud.external_client_apps.htm&language=en_US) instead. If you must continue creating connected apps, contact Salesforce Support.

See [New connected apps can no longer be created in Spring ‘26](https://help.salesforce.com/s/articleView?id=005228017&type=1&language=en_US) for more details.

When an Install button appears next to a connected app, users in your org are connecting to the app but it isn’t installed in your org. To manage an app’s security policies, such as which users can access the app and for how long, you must install the connected app in your org.

1. From Setup, enter OAuth in the Quick Find box, then select **Connected Apps OAuth Usage**.
2. Select an app and click **Install**.
3. Click **Manage App Policies** to get details about the app.
4. Click **Edit Policies** to control the app’s access policies. See [Manage Access to a Connected App](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_manage.htm&release=264.0.0&type=5 "After a connected app is installed in your org, you can manage access to it. Configure permissions and policies for the app, explicitly defining who can use the connected app and where they can access the app from. These permissions and policies, which include user-access, IP range restrictions, and multi-factor authentication (MFA), provide extra security for your org.").

#### See Also

- [Uninstall a Third-Party Connected App](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_uninstall_third_party.htm&release=264.0.0&type=5 "You can uninstall a third-party connected app from your org. However, uninstalling an app doesn’t delete the connected app. Instead it removes the OAuth policies that you set for the app in your org. Because you’re removing the policies for apps that users can still access, you’re actually loosening your security measures. We recommend uninstalling a connected app only when the original developer deletes the app from their org. To make a connected app inaccessible to your org’s users, block the app. This action ends all current user sessions with the connected app and prevents all new sessions until you unblock the app.")