---
schema_version: "1"
id: 3c183fedf184d0d6864af1ca9f46be59c4ec97e684fa425f6689f97ee69715fc
title: Deploy an External Client App with a New Global OAuth Settings File
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/deploy_external_client_app_with_global_settings_file.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.deploy_external_client_app_with_global_settings_file.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 9495b5e2a0091dc7a8196392649caee514f9b2a8650456f62458b2429549a329
description: Deploy the source org’s metadata on an org with its own OAuth consumer. To configure the app, remove the OAuth link in the OAuth settings file and add a reference to the global OAuth settings file in the package.xml manifest file on the new org.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Deploy an External Client App with a New Global OAuth Settings File

Deploy the source org’s metadata on an org with its own OAuth consumer. To configure the app, remove the OAuth link in the OAuth settings file and add a reference to the global OAuth settings file in the package.xml manifest file on the new org.

1. Open the package.xml manifest file on org 3 and make sure that it includes the ExtlClntAppGlobalOauthSettings type.
    
    ```
    <?xml version="1.0" encoding="UTF-8"?>
    <Package xmlns="http://soap.sforce.com/2006/04/metadata">
        <types>
            <members>*</members>
            <name>ExternalClientApplication</name>
        </types>
        <types>
            <members>*</members>
            <name>ExtlClntAppOauthSettings</name>
        </types>
        <types>
            <members>*</members>
            <name>ExtlClntAppGlobalOauthSettings</name>
        </types>
        <types>
            <members>*</members>
            <name>ExtlClntAppOauthConfigurablePolicies</name>
        </types>
        <version>58.0</version>
    </Package>
    ```
2. Remove the OAuth link field from the OAuth settings file.
    
    Deployment fails if there’s an OAuth link field in the settings file with incorrect information. If the field doesn’t exist, it’s generated during deployment. Best practice is to remove the OAuth link field before deployment.
3. Deploy the changes to org 3.
    
    ```
    sf project deploy start --manifest package.xml --target-org johndoe@example3.com
    ```
4. Verify that the deployment succeeds. You see all four files in the external client app.
    - Header file
    - Global OAuth settings file
    - OAuth settings file
    - Policies file
5. Verify that the settings file includes the generated OAuth link field and that the global settings file includes an OAuth consumer key and secret.

- **[Initiate the Authorize Endpoint for the Deployed External Client App with a Global Settings File](https://help.salesforce.com/s/articleView?id=xcloud.initiate_the_authorize_endpoint_for_independent_deployed_external_client_app.htm&release=264.0.0&type=5)**  
    After the new org metadata is configured with its own global OAuth settings file, initiate an OAuth flow to acquire an access token.