Troubleshooting Common Problems

The following table lists common errors or scenarios and their solutions. Use this table in addition to the Integration Manager log file to try and troubleshoot your integration before you contact SuiteProjects Pro Support.

Error / Scenario	Solution
Error "`The remote server returned an error: (403) Forbidden`"	Verify that the version of Exchange Server specified in SuiteProjects Pro Exchange Integration Setup matches the version of Exchange Server you are running on your mail server. See Connecting Exchange Integration Manager with On-Premise Exchange Server.
Error: "`Exchange Server doesn't support the requested version`"	Verify that the version of Exchange Server specified in SuiteProjects Pro Exchange Integration Setup matches the version of Exchange Server you are running on your mail server. See Connecting Exchange Integration Manager with On-Premise Exchange Server.
Error: "`Exception: The handle is invalid`" when exporting bookings from SuiteProjects Pro to user mailboxes stored in an Exchange Online organization.	Verify your Exchange Online credentials. In particular, verify that the client secret is still valid. This error is often due to an expired client secret. See Connecting Exchange Integration Manager with Microsoft Entra ID or Exchange Online and Registering Exchange Integration Manager With Microsoft Identity Platform.
Error: "`Could not lock file`" when running SuiteProjects Pro Exchange Integration Setup.	Sign in to Windows as an administrator, and run SuiteProjects Pro Exchange Integration Setup again, or right-click the shortcut and choose Run as administrator.
Error: "`Status: Access is not enabled. Please contact your SuiteProjects Pro account administrator to enable this functionality.`" when clicking File > Update in SuiteProjects Pro Exchange Integration Setup	Contact SuiteProjects Pro Support and request the following for your account: Disable and enable again Access to Exchange Integration Manager. Enable and disable again Access to SuiteProjects Pro Outlook Connector.
The Exchange user mailbox dropdown list does not include the user mailbox I want to map to the SuiteProjects Pro user record.	Verify that the user mailbox is not already mapped to another SuiteProjects Pro user record.

Error / Scenario

Solution

Error "The remote server returned an error: (403) Forbidden"

Verify that the version of Exchange Server specified in SuiteProjects Pro Exchange Integration Setup matches the version of Exchange Server you are running on your mail server. See Connecting Exchange Integration Manager with On-Premise Exchange Server.

Error: "Exchange Server doesn't support the requested version"

Error: "Exception: The handle is invalid" when exporting bookings from SuiteProjects Pro to user mailboxes stored in an Exchange Online organization.

Verify your Exchange Online credentials. In particular, verify that the client secret is still valid. This error is often due to an expired client secret. See Connecting Exchange Integration Manager with Microsoft Entra ID or Exchange Online and Registering Exchange Integration Manager With Microsoft Identity Platform.

Error: "Could not lock file" when running SuiteProjects Pro Exchange Integration Setup.

Sign in to Windows as an administrator, and run SuiteProjects Pro Exchange Integration Setup again, or right-click the shortcut and choose Run as administrator.

Error: "Status: Access is not enabled. Please contact your SuiteProjects Pro account administrator to enable this functionality." when clicking File > Update in SuiteProjects Pro Exchange Integration Setup

Contact SuiteProjects Pro Support and request the following for your account:

Disable and enable again Access to Exchange Integration Manager.
Enable and disable again Access to SuiteProjects Pro Outlook Connector.

The Exchange user mailbox dropdown list does not include the user mailbox I want to map to the SuiteProjects Pro user record.

Verify that the user mailbox is not already mapped to another SuiteProjects Pro user record.