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.

Introduced in API version 33.0.

describeSObjects(), query(), retrieve()

  • 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.
  • 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.
  • Type: string
  • Properties: Filter, Group, idLookup, Sort
  • Description: The unique name for this object.
  • Type: picklist

  • Properties: Filter, Group, Nillable, Restricted picklist, Sort

  • Introduced: API version 58.0

  • 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.

    These values are available in API version 59.0 and later.

    These values are available in API version 65.0 and later.

  • Possible values:

    • 1 — 1 — 1 Minute
    • 5 — 5 — 5 Minutes
    • 10 — 10 — 10 Minutes
    • 15 — 15 — 15 Minutes
    • 30 — 30 — 30 Minutes
    • 60 — 60 — 1 Hour
    • 90 — 90 — 90 Minutes
    • 120 — 120 — 2 Hours
    • 240 — 240 — 4 Hours
    • 480 — 480 — 8 Hours
    • 720 — 720 — 12 Hours
  • 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.
  • Type: boolean
  • Type: boolean
  • Type: boolean
  • Properties: Filter
  • Description: Specifies whether the connected app requires a High Assurance level session.
  • Type: boolean
  • Type: boolean
  • Type: boolean
  • 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.
  • Type: boolean
  • Type: boolean
  • Properties: Filter
  • Description: If true, the OAuth 2.0 token exchange flow is enabled.
  • Type: boolean
  • 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.
  • 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.
  • 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.
  • Type: picklist

  • Properties: Filter, Group, Nillable, Restricted picklist, Sort

  • Introduced: API version 57.0

  • 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.

    These values are available in API version 59.0 and later.

    These values are available in API version 65.0 and later.

  • Possible values:

    • 1 — 1 — 1 Minute
    • 5 — 5 — 5 Minutes
    • 10 — 10 — 10 Minutes
    • 15 — 15 — 15 Minutes
    • 30 — 30 — 30 Minutes
    • 60 — 60 — 1 Hour
    • 90 — 90 — 90 Minutes
    • 120 — 120 — 2 Hours
    • 240 — 240 — 4 Hours
    • 480 — 480 — 8 Hours
    • 720 — 720 — 12 Hours