---
schema_version: "1"
id: 7400bbea83949c1b55da9976cafbb0afd0b4bae23392339496540df55841b431
title: Set Up a New External Client App (ECA) in Mobile Publisher
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/branded_apps_eca_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_eca_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: d78a9fec8f6f41c6086f87294b324e7a5f031104e025f6a2adda4a5a6223a5e0
description: Start setting up an external client app (ECA) for your mobile app after completing the Set Up the Mobile App step in Mobile Publisher. Don’t create your external client app in the External Client App manager (accessed through Setup). Create your ECA in Mobile Publisher instead.
products:
  - Experiences
  - Mobile App
  - Cross Cloud
release: "264"
---
# Set Up a New External Client App (ECA) in Mobile Publisher

Start setting up an external client app (ECA) for your mobile app after completing the Set Up the Mobile App step in Mobile Publisher. Don’t create your external client app in the External Client App manager (accessed through Setup). Create your ECA in Mobile Publisher instead.

### 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;">Setup for Mobile Publisher available in: Lightning Experience</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: production only (not sandbox)</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in Lightning Experience in: <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</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="d20286e89">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d20286e89 ">To create and modify a Mobile Publisher project:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d20286e89 ">Manage mySalesforce Apps</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d20286e89 ">To create and modify a site:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d20286e89 ">Create and Set Up Experiences</td>

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

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/images/icon_important.png)

Important Important: If you are creating an ECA to test it in a sandbox, don’t create the ECA directly in the sandbox. Create the ECA in the production environment first, and then deploy it to your sandbox.

Click **Start** to set up the External Client App, and fill in the fields.

1. Name
2. Description
3. Contact Email
4. Contact Phone
5. Icon (PNG file no larger than 100 KB. The image must be 128x128 pixels, and have a 1:1 aspect ratio.)
6. Push Notifications. If enabled, add the following fields for iOS:
    
    - 1. Authentication for Push Notifications
        2. Signing Key or Certificate
        3. [Key ID (ID of your App Store Connect API key)](https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_exp_distribution_delegated_public_ios_enter.htm&type=5&language=en_US)
        4. [Team ID (Team ID listed in your company’s Apple Developer account)](https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_apple_id_config.htm&type=5&language=en_US)
7. Push Notifications. If enabled, for Android upload the Firebase Admin SDK private key from the Google Firebase project associated with your app.
8. Click **Save** and **Deploy**. Select a target for the ECA deployment: production or sandbox. The first deployment must be to the production org. After the ECA is deployed in production, you can then deploy to a sandbox org for testing purposes.
    
    ![The confirmation window when deploying an ECA, showing the options of a production org and a sandbox.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/branded_apps_exp_cloud/images/deploy_eca.png)
9. After you select a target, the Deployed To field shows where the ECA version is available. A Live status means that the app is live in production. The Deployed status, when coupled with a sandbox entry in the Deployed To column, indicates that the app is deployed in a sandbox environment.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/images/icon_note.png)

Note

- If you create a new sandbox, or your existing sandbox is refreshed after the ECA is deployed to the production org, the sandboxes get the same version of the ECA as the production org. You don’t need to explicitly deploy the ECA in the sandbox.
- If you need to change the name or icon of your ECA, you must create a new version and redeploy it.

- **[Manage External Client App Versions in Mobile Publisher](https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_eca_manage_versions.htm&release=264.0.0&type=5)**  
    After you set up your external client app, you can see its settings in the External Client App Settings tab.