How to fix Salesforce integration problems
Last updated: October 26, 2026
Use this guide if your Salesforce integration is not connecting, has stopped syncing, or shows an error. For the full setup steps, see How to connect Salesforce to N.Rich.
The sync has stopped and N.Rich asks you to reauthorise
When the Salesforce authorisation expires, N.Rich can no longer sync with your Salesforce instance and data sync is paused. Admins of your N.Rich account will see an alert across most pages in the platform, prompting them to reauthorise the connection.
To fix it:
Go to Settings (cog icon) > CRM.
Click RESET AUTHENTICATION.
Sign in again with the same Salesforce user.
Turn your settings back on and click SAVE. Reconnecting turns all toggles off.
The next sync will backfill any data that couldn't be pushed to your Salesforce accounts while the connection was down.

N.Rich shows an alert that the Salesforce user doesn't have enough permissions
The Salesforce user you connected N.Rich with is missing permissions N.Rich needs, so part of the sync can't run. For example, Salesforce rejects N.Rich's updates when that user isn't allowed to edit the N.Rich fields. N.Rich shows an alert in the platform until this is fixed.
To fix it:
Ask your Salesforce admin to give the connected user read and edit access to all N.Rich fields and objects. See Which Salesforce fields and objects do I need to create?
Check the user meets the prerequisites in How to connect Salesforce to N.Rich.
If the alert is still there after the next sync, reach out to your Solutions Engineer.
Your toggles are off after reconnecting
Clicking RESET AUTHENTICATION or reconnecting Salesforce creates a fresh connection and turns all toggles off.
To fix it:
Go to Settings (cog icon) > CRM.
Turn your toggles back on.
Click SAVE.
The next sync backfills data that could not be pushed while you were disconnected. See What does each CRM setting do? for what each toggle controls.
The sync still doesn't work after reconnecting
This usually means the N.Rich app was installed manually from the Salesforce AppExchange before connecting from N.Rich. When that happens, Salesforce doesn't send N.Rich the information it needs to keep the connection active, so the sync stops again even after you reconnect.
The N.Rich app is installed automatically when you connect from N.Rich. It should never be installed from the AppExchange. This is separate from the N.Rich AI apps in Salesforce package.
To fix it:
In Salesforce, go to Setup > Apps > Packaging > Installed Packages.
Find the N.Rich package and click Uninstall.
Confirm the uninstall.
In N.Rich, reconnect Salesforce from Settings (cog icon) > CRM > Salesforce CRM.
Let your Solutions Engineer know via the chat once it's done, so they can confirm the connection is working.
Reconnecting alone will not fix this. Uninstall the app installed from the AppExchange first, then reconnect from N.Rich.
You can't uninstall the N.Rich app
Some Salesforce orgs have internal policies that require apps to stay installed. If you see an error such as "app must be installed into org", or your Salesforce admin can't remove the app, reach out to your Solutions Engineer. They will work with your Salesforce admin to resolve it.
You get an OAuth error when connecting
The Salesforce user you're connecting with is missing the Approve Uninstalled Connected Apps permission. Without it, Salesforce blocks the connection.
To fix it:
In Salesforce, open the profile or permission set assigned to your N.Rich API user.
Under System Permissions, enable Approve Uninstalled Connected Apps.
Save, then try connecting again from N.Rich.
You can't connect with an Integration User licence
The N.Rich integration needs a full Salesforce licensed user. The Salesforce Integration User licence is not supported because the connection uses a browser-based login (OAuth), which that licence doesn't allow.
To fix it: create a dedicated user with a full Salesforce licence and connect with that user. See the prerequisites in How to connect Salesforce to N.Rich.
The connection drops or fails because of IP restrictions
If your Salesforce org restricts access by IP address, N.Rich must be allowed to connect.
Check the following:
All N.Rich IP addresses are added as trusted IPs in Salesforce. See the full list in How to connect Salesforce to N.Rich.
Lock sessions to the IP address from which they originated is turned off. N.Rich doesn't always connect from the same IP address, so this setting can break the connection. In Salesforce, go to Setup > Session Settings and uncheck this option.
An account doesn't sync or shows as New prospect
N.Rich links a Salesforce account only when its Website field contains a valid company domain and at least one contact on the account has an email on that same domain. Subdomains must match exactly.
To fix it: check the Website field and the contact email domains on the account. See How does N.Rich match Salesforce accounts by domain?
Segment push fails with "Unable to find object: nrich_AccountSegment__c"
The Push account segment data to CRM toggle is on, but the custom object nrich_AccountSegment__c does not exist in Salesforce.
To fix it:
Create the custom object and its fields as described under "Segments object" in Which Salesforce fields and objects do I need to create?
Follow How to push segment membership to Salesforce to finish the setup.
What's next
Need help? Reach out to your Solutions Engineer via the chat in the bottom-left corner of the N.Rich platform, by email or Slack.