---
schema_version: "1"
id: 5d6199a1b8f482aba4431db1329c78dcb7a8da0e1d39c973274daa6617b3822d
title: Create 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/create_a_local_external_client_app.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: af2e3b9cff0e3ea0aa7a4f9cf3459ea51453c3bb2209f4d72f44464f89656461
description: Create an external client app in App Manager. Local external client apps are available only on the org where you create them. Packageable external client apps can be packaged for distribution to other orgs.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Create an External Client App

Create an external client app in App Manager. Local external client apps are available only on the org where you create them. Packageable external client apps can be packaged for distribution to other 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: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Professional</strong>, <strong>Enterprise</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="d55215e52">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d55215e52 ">To create local External Client Apps</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d55215e52 ">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, “Create a new 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. Click **New External Client App**.
3. Enter a name for the external client app to display in the External Client App Manager.
4. Enter the API name to be used when referring to your app from a program.
    
    This field defaults to a version of the external client app’s name with underscores in place of spaces. There are rules for API names. If the app name contains any characters forbidden by the API name rules, edit the default API name.
    
    - It must use only letters, numbers, and underscores.
    - It must be unique.
    - It must begin with a letter.
    - It can’t include spaces.
    - It can’t end with an underscore.
    - It can’t contain two consecutive underscores.
5. Enter the contact email for Salesforce to use in case we want to contact you or your support team.
    
    This address isn’t given to Salesforce admins who install the app.
6. Determine the distribution state.
    - To develop an external client app for your local org, set the Distribution State to **Local**.
    - To develop an external client app for packaging and distribution, set the Distribution State to **Packaged**.

- **[Enable an OAuth Plugin](https://help.salesforce.com/s/articleView?id=xcloud.enable_oauth_plugin.htm&release=264.0.0&type=5)**  
    In an external client app, configurations are divided between settings and policies for each plugin. To add an external client app plugin, enable the plugin and configure the settings.
- **[Configure the External Client App's SAML 2.0 Settings and Policies](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_saml.htm&release=264.0.0&type=5)**  
    To integrate a service provider with your Salesforce org, you can use an external client app that implements SAML 2.0 for user authentication. Salesforce supports SAML single sign-on (SSO) when the service provider or the identity provider initiates the flow. To use this option, configure an external client app with SAML 2.0 enabled for your service provider. Define your Salesforce org as the SAML identity provider.
- **[Configure the External Client App’s Canvas App Settings and Policies](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_canvas.htm&release=264.0.0&type=5)**  
    The Canvas plugin for an external client app enables you to integrate a third-party application in Salesforce. Configure the external client app’s Canvas app settings and policies in External Client App Manager.
- **[Configure the External Client App’s Mobile App Settings and Policies](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_mobile_settings_policies.htm&release=264.0.0&type=5)**  
    The mobile app plugin for an external client app enables mobile-specific features, such as screen lock upon a custom timeout value. Configure the external client app’s mobile app settings and policies in External Client App Manager.
- **[Configure the Push Notification Plugin](https://help.salesforce.com/s/articleView?id=xcloud.enable_push_notification_plugin.htm&release=264.0.0&type=5)**  
    The push notification plugin for an external client app enables a mobile app’s push notifications for an Android or iOS device.
- **[Configure the External Client App’s Notification Settings](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_notification_settings.htm&release=264.0.0&type=5)**  
    With the notifications plugin for an external client app, you can subscribe the mobile app to custom notification types. Enable the notifications plugin, and subscribe the mobile app to notification types in External Client App Manager.
- **[Set Up OAuth Flows](https://help.salesforce.com/s/articleView?id=xcloud.external_client_apps_oauth_flow_config.htm&release=264.0.0&type=5)**  
    External Client Apps support several OAuth flows. These flows allow the third-party application to access protected resources on Salesforce.