Troubleshooting
Common issues and how to resolve them.
Connection and auth
| Problem | Solution |
|---|---|
| Cannot connect Salesforce org | Ensure you are a Workspace Admin; see Connecting environments |
| OAuth redirect blocked | Allow pop-ups for revsnap.forceweaver.com |
| Runs fail with auth error | Reconnect the org: see Environment troubleshooting |
Snapshots and runs
| Problem | Solution |
|---|---|
| Cannot capture snapshot | Verify the org is connected and healthy; check your snapshot limit on billing |
| Approval capture fails (inactive flow) | Activate the approval flow in Salesforce, then re-capture: see Approval testing |
| Approval preview returns no chains | Confirm the quote still meets the approval conditions for that flow |
| Cannot run a snapshot against another org | Expected: snapshots run only against the org they were captured from |
| Run shows unexpected diffs | Review the diff view: the change may be intentional; re-capture if you want a new baseline |
| Run stuck in progress | Refresh the page; check org health; contact support if it persists beyond 10 minutes |
Plans and limits
| Problem | Solution |
|---|---|
| "Limit reached" message | Check usage on billing page and upgrade your plan |
| Feature locked (padlock icon) | The feature requires a higher plan: see Plans |
| Promotional allowance expired | Upgrade or contact your admin for a new override |
Schedules
| Problem | Solution |
|---|---|
| Schedule did not run | Verify it is active and the target tag/snapshots exist |
| Cannot pick a time slot | Another active schedule uses that hour: choose a different slot |
| Wrong timezone | Schedules run in UTC: adjust your slot accordingly |
CI/CD
| Problem | Solution |
|---|---|
| CLI returns auth error | Verify REVSNAP_API_KEY is set and not revoked |
| Pipeline cannot reach Salesforce | Ensure your pipeline's Salesforce auth step runs before the Revsnap step |
| Exit code 1 on passing run | Check whether the snapshot name or tag API name matches exactly |
Getting help
- Review the relevant guide in this documentation
- Visit the Trust center for security and compliance questions
- Contact your workspace admin or Revsnap support for account-specific issues