Run the Salesforce diagnostic tool
Updated
Who can do this: Super Admins and Integrators
The Salesforce diagnostic tool runs a set of tests against your Salesforce connection, using one Salesforce record you choose. When it finishes, you'll see which tests passed and the error text for any that failed.
This feature is available when it's turned on for your organization. If you don't see it, contact your OnRamp team.
Before you begin
Connect your Salesforce account under Settings > Integrations+.
Know which Salesforce record you want to test against, such as an Opportunity. You'll search for it by a text or number field, like its name.
Run the diagnostic tool
Go to Settings > Integrations+.
Select the Salesforce integration to open its page.
At the top of the page, select Run Diagnostics. The Salesforce Diagnostic Tool opens. Run Diagnostics shows only when Salesforce was set up through Integrations+.
In Object type, choose the Salesforce object to test, such as Opportunity. The list comes from your connected Salesforce org.
Optional: In Search by Field, choose a different field to search by. It defaults to a name field and lists only text and number fields.
In Entity, enter at least three characters, then select the record. If you search by an ID field, enter the full, exact ID.
Select Start. It stays unavailable until you've chosen an object type and a record.
The tests take a while. Keep the dialog open until they finish, or you won't see the results. A message tells you when the run completes. If the run fails or doesn't finish in time, a message says so. Any results that came back still show in the dialog.
The dialog doesn't close when you select outside it. While the tests run, Cancel is unavailable. Once the run completes, fails or runs out of time, select Cancel to close the dialog. When you open it again, the earlier results are cleared.
If the record search in Entity shows an error, retry the search. If it keeps failing, reconfigure the Salesforce integration under Settings > Integrations+.
Note: Run Diagnostics appears only on the Salesforce integration's page. You won't see it for other integrations. If your Salesforce connection is one OnRamp maintains for you, rather than one set up through Integrations+, it doesn't appear either.
Read the results
Results appear under Results, grouped by category. Each test shows:
✅ when it passed.
❌ when it failed, with the error text underneath.
Read the error text under each failed test to find the cause. A failure can mean the Salesforce user you connected with is missing permission to an object, a field, or the record. To fix that, update the integration user's permission set in Salesforce. Configure Salesforce Permissions for OnRamp Project Automation walks through it.
If a run stops reporting progress, it's marked as failed. You'll see a failed Diagnostic Run test under System with the message This run stopped reporting progress and did not complete. Please try again. Start a new run to try again.
After you change permissions in Salesforce, run the tool again to confirm the fix.