Assign an OAuth Custom Scope to an External Client App

After you create an OAuth custom scope in your Salesforce org, you can assign it to an external client app to set data-access permissions for the app. For example, an external client app with an order_status custom scope has the correct permission set to access order status data from the external entity.

Required Editions

Available in: both Salesforce Classic and Lightning Experience

External client apps can be created in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions

External client apps can be installed in: All editions

User Permissions Needed
To manage, create, edit, and delete OAuth apps: Manage external client apps

Typically, to receive custom scopes that are assigned to an external client app, you must include the scope parameter in the authorization request. With the OAuth 2.0 JWT bearer flow, for external client apps that are pre-authorized, custom scopes are automatically returned with an access token. For more information, see OAuth 2.0 JWT Bearer Flow for Server-to-Server Integration.

  1. From Setup, in the Quick Find box, enter external client apps, and select External Client Apps Manager.
  2. From the list, select the external client app.
  3. Expand the OAuth Policies section of the Policies page.
  4. Select the OAuth custom scopes to assign to the external client app, and save your updates.