---
schema_version: "1"
id: 97eb3da73e411e8722e3162a073908a035b08c239b2b45249b16fd51cd6f991e
title: ConnectedAppSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_connectedappsettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_connectedappsettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 77778afb0e7d4d6ba28e93ab1e64bf5934ead2bf6ed9bd7e2a9852d8d14287f1
description: Represents settings for connected apps. This type extends the Metadata metadata type and inherits its fullName field.
---
# ConnectedAppSettings

Represents settings for connected apps. This type extends the Metadata metadata type and inherits its fullName field.

## File Suffix and Directory Location

ConnectedAppSettings values are stored in a single file named ConnectedApp.settings in the settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

## Version

ConnectedAppSettings components are available in API version 47.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| enableAdminApprovedAppsOnly | boolean | If false (default), any connected app can call the Salesforce API. If true, only apps that have been approved or installed by the admin can call the Salesforce API. To access this field, you must contact Salesforce Customer Support to enable API Access Control. |
| enableAdminApprovedAppsOnlyForExternalUser | boolean | If false (default), authenticated customers or partners can use any unblocked connected app to access the Salesforce API. If true, authenticated customers and partners can’t access the Salesforce API unless they use a connected app that is installed in the org and unblocked. Install and unblock connected apps on the Connected Apps OAuth Usage page. To access this field, you must contact Salesforce Customer Support to enable API Access Control. |
| enableSkipUserProvisioningWizardWelcomePage | boolean | If false (default), the User Provisioning Wizard Welcome page shows up when you access the wizard. To skip the welcome page in the future, you can select **Do not show me this next time**. If true, the Welcome page doesn’t show up the next time that you access the wizard. |

## Declarative Metadata Sample Definition

The following is an example of a ConnectedAppSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<ConnectedAppSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableAdminApprovedAppsOnly\>false</enableAdminApprovedAppsOnly\>
    <enableAdminApprovedAppsOnlyForExternalUser\>false</enableAdminApprovedAppsOnlyForExternalUser\>
    <enableSkipUserProvisioningWizardWelcomePage\>true</enableSkipUserProvisioningWizardWelcomePage\>
</ConnectedAppSettings\>

The following is an example package.xml manifest that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>ConnectedApp</members\>
        <name\>Settings</name\>
    </types\>
    <version\>47.0</version\>
</Package\>