Salesforce connected apps usually disconnect for one of five reasons: an inactive connected user, missing permissions, IP restrictions on the connected app, a restricted permitted users setting, or an installation that never finished. When Salesforce rolls out security updates, connected apps sometimes stop working. If you’ve recently noticed integrations failing or OAuth errors appearing, you’re not alone. This guide walks through the most common causes and how to fix them.
A connected app is the framework Salesforce uses to let an external application authenticate into your org and access its data through APIs and standard protocols such as OAuth 2.0. When that authentication breaks, the app disconnects.
The connected user has been deactivated or is missing permissions — reactivate the user or grant the right permissions.
An OAuth error appeared after a Salesforce security update — relax the IP restrictions on the connected app.
The app works for some users but not others — check the permitted users setting.
The app shows in OAuth usage but was never fully installed — complete the installation from Load Actions.
You are not sure the app is really down — check the last used date on the connected app.
Start with the connected user. Before troubleshooting deeper, verify two things: Is the connected user still active in your Salesforce org? Do they have the appropriate permissions? A deactivated user or missing permissions will break any app connection tied to that account. This is the fastest fix and often the culprit.
OAuth authentication failures are among the most frequent issues we see after Salesforce security changes. The connected app stops authenticating because Salesforce has tightened its security posture, and IP restrictions are often the reason.
Here’s how to relax IP restrictions on a Salesforce connected app:
Navigate to Setup in Salesforce
Find the connected app in question
Look for IP restriction settings
Select “Relax IP Restrictions” to loosen these limits
Before making changes, check with your IT team to ensure you’re not creating compliance issues. Relaxing IP restrictions improves connectivity but should align with your organization’s security policies. If you’re managing multiple security layers, understanding Salesforce’s new login defenses and anomaly detection can help you balance connectivity with protection.
Connected apps have a permitted users setting that controls who can use them. By default, this may be open to all users, but you can restrict it to admins or pre-authorized users only. This adds a layer of security and can help prevent unauthorized access.
If your connected app is disconnecting for specific users, check whether they’re in the permitted users list. If not, add them or adjust the setting to allow broader access, depending on your security requirements.
When you install a new app and it fails, Salesforce adds it to the OAuth usage section even though the installation didn’t complete. This can cause confusion later.
To resolve a failed connected app installation:
Find the failed app in your connected apps OAuth usage section
Check if it has usage restrictions applied
Select “Load Actions” to see available options
Complete the installation from there
Once installed properly, the app should appear under your managed connected apps, where you can edit settings as needed. If you’re dealing with multiple integrations, understanding the integration trap in your sales stack can help you avoid cascading failures when adding new tools to your stack.
The last used date on a connected app tells you whether it’s actually stopped firing or if it’s a sync error. If an app shows an old last used date, it may have genuinely disconnected. If the date is recent, the issue might be intermittent or specific to certain operations.
Check the connected user’s profile to see these details. This helps you distinguish between a real disconnection and a temporary glitch.
A connected app is the framework Salesforce uses to let an external application authenticate into your org and access its data through APIs and standard protocols such as OAuth 2.0. Connected apps are managed in Salesforce Setup, where you control their IP restrictions, permitted users and OAuth policies.
Most connected apps stop working after a Salesforce security update tightens authentication. The usual causes are a deactivated connected user, missing permissions on that user, or IP restrictions on the connected app that now block the calling service.
In Salesforce Setup, find the connected app, look for its IP restriction settings and select “Relax IP Restrictions”. Check with your IT team before making the change so it stays aligned with your organization’s security policies.
Check the permitted users setting on the connected app. If it is restricted to admins or pre-authorized users only, anyone outside that list will be blocked. Add the affected users or adjust the setting to allow broader access, depending on your security requirements.
Salesforce adds the app to the OAuth usage section even though the installation didn’t complete. Find the failed app there, check whether it has usage restrictions applied, select “Load Actions” and complete the installation so it moves into your managed connected apps.
Check the last used date on the connected app from the connected user’s profile. An old last used date suggests the app has genuinely disconnected, while a recent date points to an intermittent issue or one specific to certain operations.
If you’ve worked through these steps and connected apps are still disconnecting, the issue may be more complex. Salesforce security changes sometimes require custom configuration or API adjustments. Your Salesforce admin or a certified Salesforce partner can help diagnose whether the problem is on Salesforce’s side or with the app itself.
For more details on managing connected apps, Salesforce’s official documentation on managing OAuth access for connected apps covers the full range of settings and options.
If you’re looking for hands-on support with Salesforce configuration and troubleshooting, Concept’s Salesforce consulting services can help you resolve complex integration issues and optimize your connected app strategy.