--- schema_version: "1" id: 4a197d31c8a5731fd35a5c48be92df69f55149e62d8cbd3b582719051a2e2622 title: ConnectedApplication collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_connectedapplication.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_connectedapplication.htm source_site: developer.salesforce.com content_type: documentation content_hash: 7966a6c89134be4c49cb249dbf52c352db98ab505781f66a4911840d471998a1 description: Represents a connected app and its details; all fields are read-only. --- # ConnectedApplication Represents a connected app and its details; all fields are read-only. Connected apps link client applications, third-party services, other Salesforce organizations, apps, and resources to your organization. The connected app configuration specifies authorization and security settings for these resources. This object exposes the settings for a specified connected app. ## Supported Calls describeSObjects(), query(), retrieve() ## Fields | Field Name | Details | | --- | --- | | MobileSessionTimeout | Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description Length of time after which the system logs out inactive mobile users. | | MobileStartUrl | Type url Properties Filter, Nillable, Sort Description Users are directed to this URL after they’ve authenticated when the app is accessed from a mobile device. | | Name | Type string Properties Filter, Group, idLookup, Sort Description The unique name for this object. | | NamedUserUvidTimeout | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The timeout value for a JSON Web Token (JWT)-based access token that's issued to a named user. This field defines the timeout only if the app is configured to have an app-specific timeout. If the app uses the user's session timeout, the timeout value is defined based on the user's profile or the org session settings. For more information about defining JWT-based access token timeout, see [Configure a Connected App to Issue JWT-Based Access Tokens](https://help.salesforce.com/s/articleView?id=xcloud.jwt_connectedapp_enable.htm&language=en_US). These values are available in API version 59.0 and later. - 1—1 Minute - 5—5 Minutes - 10—10 Minutes - 15—15 Minutes - 30—30 Minutes These values are available in API version 65.0 and later. - 60—1 Hour - 90—90 Minutes - 120—2 Hours - 240—4 Hours - 480—8 Hours - 720—12 Hours This field is available in API version 59.0 and later. | | OptionsAllowAdminApprovedUsersOnly | Type boolean Properties Filter Description Indicates whether access is limited to users granted approval to use the connected app by an administrator. Manage profiles for the app by editing each profile’s Access list. | | OptionsCodeCredentialGuestEnabled | Reserved for future use. | | OptionsFullContentPushNotifications | For internal use only. | | OptionsHasSessionLevelPolicy | Type boolean Properties Filter Description Specifies whether the connected app requires a High Assurance level session. | | OptionsIsInternal | For internal use only. | | OptionsRefreshTokenValidityMetric | Type boolean Properties Filter Description Specifies whether the refresh token validity is based on duration or inactivity. If true, the token validity is measured based on the last use of the token; otherwise, it’s based on the token duration. | | OptionsTokenExchangeManageBitEnabled | Type boolean Properties Filter Description If true, the OAuth 2.0 token exchange flow is enabled. | | PinLength | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description For mobile apps, this field is the PIN length requirement for users of the connected app. Valid values are 4, 5, 6, 7, or 8. | | RefreshTokenValidityPeriod | Type int Properties Filter, Group, Nillable, Sort Description The duration of an authorization token until it expires in hours, months, or days as set in the connected app management page. | | StartUrl | Type url Properties Filter, Nillable, Sort Description If the app isn’t accessed from a mobile device, users are directed to this URL after they’ve authenticated. | | UvidTimeout | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The timeout value for a JWT-based access token that's issued to an unknown user as a result of the guest user variation of the Authorization Code and Credentials Flow. JWT-based access tokens issued during this flow variation always contain a UVID. This field defines the timeout only if the app is configured to have an app-specific timeout. If the app uses the user's session timeout, the timeout value is defined based on the user's profile or the org session settings. For more information about defining JWT-based access token timeout, see [Configure a Connected App to Issue JWT-Based Access Tokens](https://help.salesforce.com/s/articleView?id=xcloud.jwt_connectedapp_enable.htm&language=en_US). These values are available in API version 59.0 and later. - 1—1 Minute - 5—5 Minutes - 10—10 Minutes - 15—15 Minutes - 30—30 Minutes These values are available in API version 65.0 and later. - 60—1 Hour - 90—90 Minutes - 120—2 Hours - 240—4 Hours - 480—8 Hours - 720—12 Hours This field is available in API version 59.0 and later. |