Workato · Salesforce connector
Salesforce connection disconnects repeatedly (Connection lost)
Short answer
A Salesforce connection that keeps showing "Connection lost" usually means Salesforce is not returning a refresh token. Grant the "Perform requests at any time" scope, then check the Refresh Token Policy and IP Relaxation settings.
VerifiedLast verified
01Error text
Connection lost02Likely causes
- Salesforce issues a refresh token only when the app's OAuth policies grant the Perform requests at any time scope. Full access does not include it by default.
- A Refresh Token Policy or IP Relaxation setting can cause the same symptom.
03How to fix it
- For a custom OAuth profile, add Perform requests at any time (refresh_token, offline_access) to the external client app's Selected OAuth Scopes.
- For the default OAuth 2.0 connection, go to Setup > Apps > App Manager, open the Connected App named "Workato connector", select Manage and check the scope under OAuth Policies.
- Check Refresh Token Policy. Avoid Immediately expire refresh token, and keep any idle window longer than the gap between recipe runs.
- Set IP Relaxation to Relax IP restrictions, or add Workato IPs to Setup > Security > Network Access or the integration user's Login IP Ranges.
- Check Lock sessions to the IP address from which they originated under Setup > Security > Session Settings.
- Reconnect the connection.
04Official documentation
→Related errors
- Salesforce connection failed: action failed due to server error"action failed due to server error" appears when you click Connect on a Salesforce connection and it fails. Check the Sandbox field against your domain, your custom OAuth settings, your IP allowlist and whether Salesforce has blocked the Workato app.
- 401 UnauthorizedA 401 Unauthorized error in Workato means the external service rejected the authentication credentials sent with the request. Disconnect the app connection and reconnect it with valid, current credentials.
- Microsoft Graph API connection disconnects after one hourAn HTTP connection to Microsoft Graph that disconnects after an hour is missing a refresh token, because the OAuth scope lacks offline_access. Add offline_access to the OAuth 2.0 scope field, save and reconnect.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer