Edit an OAuth Custom Scope

You can change the name and description of a custom scope, and update your selection to include the custom scope in the OpenID Connect discovery endpoint.

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
  1. From Setup, enter Custom Scopes in the Quick Find box, and select OAuth Custom Scopes.
  2. Find the OAuth custom scope to update, and click Edit.
  3. Edit the custom scope’s values, as needed.
    • The name must be unique, begin with a letter, and include only alphanumeric characters and underscores. You can’t use spaces in custom scope names. The corresponding policy in your external entity must have the exact name as the custom scope.
    • The description must be unique, include only alphanumeric characters, and not be more than 60 characters. You can enter a custom label in place of a description. An advantage of custom labels is that you can maintain reusable text in a single location and translate the text into multiple languages. See Custom Labels.
      Note
      Note The same description formatting requirements apply to the custom labels that are associated with custom scopes.
    • To include the custom scope in the external client app’s OpenID Connect discovery endpoint (https://<your_domain_name>.my.salesforce.com/.well-known/openid-configuration), select Include on well known endpoint.
  4. After completing your edits, click Save.