---
schema_version: "1"
id: e673dd26f2b4481d38db6118a31115c3e894c1181e5b52b0a0528c0156a40c49
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_sapps_eca_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.branded_sapps_eca_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 210593ff310b661052f6f9d7809b6f91ce1527aa0882c5e026e0a5b6cfbdaeba
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:
  - 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 style="width:100%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: production only (not sandbox)</td></tr><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="d1157e72">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d1157e72 ">To create and modify a Mobile Publisher project:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d1157e72 ">Manage mySalesforce Apps</td>
          </tr>
        </tbody>
      </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/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_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_private_ios_register_bundle.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.
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-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/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_sapps_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.