Loading
Salesforce now sends email only from verified domains. Read More
Identify Your Users and Manage Access
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            View and Rotate the Consumer Key and Consumer Secret of a Connected App

            You are here:

            1. Salesforce Help
            2. Docs
            3. Identify Your Users and Manage Access

            View and Rotate the Consumer Key and Consumer Secret of a Connected App

            Keep your connected apps secure by periodically changing your consumer key (client ID) and consumer secret (client secret). To make sure that your existing integrations don’t break, generate staged consumer details and share them with your connected app integrations. When you're ready, apply the new consumer details.

            Required Editions

            Available in: both Salesforce Classic and Lightning Experience

            Connected Apps can be created in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions

            Connected Apps can be installed in: All editions
            User Permissions Needed
            To read, create, update, or delete connected apps:

            Customize Application AND either

            Modify All Data OR Manage Connected Apps
            To update all fields except Profiles, Permission Sets, and Service Provider SAML Attributes:

            Customize Application AND either

            Modify All Data OR Manage Connected Apps
            To update Profiles, Permission Sets, and Service Provider SAML Attributes: Customize Application AND Modify All Data AND Manage Profiles and Permission Sets
            To rotate the consumer key and consumer secret: Allow consumer key and secret rotation
            To install and uninstall connected apps:

            Customize Application AND either

            Modify All Data OR Manage Connected Apps
            To install and uninstall packaged connected apps:

            Download AppExchange Packages AND Customize Application AND either

            Modify All Data OR Manage Connected Apps
            Note
            Note Connected apps creation is restricted as of Spring ‘26. You can continue to use existing connected apps during and after Spring ‘26. However, we recommend using external client apps instead. If you must continue creating connected apps, contact Salesforce Support.

            See New connected apps can no longer be created in Spring ‘26 for more details.

            To avoid issues with your integrations, keep track of your app's consumer details and source org. Don't use a sandbox as the source org for a production app. If you delete or refresh a sandbox, the app's consumer details can become unusable, breaking your integrations.

            1. From Setup, in the Quick Find box, enter Apps, and then select App Manager.
            2. Find the connected app, click Action dropdown, and then select View.
            3. Next to Consumer Key and Secret, click Manage Consumer Details.
              You’re prompted to verify your identity using one of your registered methods. You can view the consumer details page for up to 5 minutes before you’re prompted to verify your identity again.
            4. To generate new values for the consumer key and consumer secret, under Staged Consumer Details, click Generate.
              Each time you generate staged values for the consumer key and secret, you overwrite the existing staged values. You can generate new staged values at any time. Staged values aren’t valid until you apply them.
            5. Share the staged consumer details with your connected app admins and integrations.
            6. When you’re ready to use the staged consumer details, click Apply.
              Warning
              Warning You can’t revert this change. All existing access and refresh tokens associated with the connected app are revoked when you apply the new consumer details.
            7. Click Apply again to accept the warning.
              Immediately after you apply the new consumer details, you can experience up to 10 minutes of unstable behavior as the changes are propagated to the connected app and its integrations. During this time, the old and new consumer details work intermittently. After this 10-minute period, the new consumer details replace the previous values, and only the new consumer details work.
             
            Loading
            Salesforce Help | Article