From Corporate V4.2, this integration is self-service. Luminance Account Administrators can configure and manage the integration directly in Luminance.
Supported features
Feature | Details |
Document sync | Sync documents from HighQ to Luminance |
Folder-level sync | Sync specific folders from HighQ workspaces |
Automatic updates | Sync new documents periodically |
iSheet reporting | Push Luminance Insights data to HighQ iSheets |
Division-level configuration | Configure sync per Division |
HighQ Integration Setup Guide
Note: You need Administrator access to HighQ Collaborate with API registration permissions and Account Administrator access to Luminance to complete this setup
Step 1: Register an API Application in HighQ
Log in to HighQ Collaborate as an administrator
Go to the API registration page:
https://<your-highq-instance>/listAPIRegistration.actionReplace
<your-highq-instance>with your HighQ URL (e.g., company.highq.com)
Create a new API registration
Configure the redirect URL to https://<your-luminance-url>/auth/callback
Copy the Client ID and Client Secret
Note: If you experience callback issues, try leaving the Redirect URL field empty in HighQ
Step 2: Create the Integration in Luminance
Log in to Luminance as an Account Administrator
Go to Account Settings → Integrations
Click Create Integration
Select HighQ
Complete the fields as described below
Click Create
Authorize the connection in HighQ
Field | Description | Example |
Name | Enter a name for the integration | HighQ Production |
Host | Enter your HighQ instance URL (hostname only, or hostname/instance) | company.highq.com |
Type | Leave as Sync | Sync |
Client ID | Enter the Client ID | abcdef1234567890 |
Client Secret | Enter the Client Secret | xxxxxxxxxxxxxxxx |
Note: Enter only the hostname. Do not include https:// or trailing slashes
Step 3: Configure sync in Luminance
Go to Upload & File Management
Select the required division
Select or create a folder
Open the Information panel
Click the settings icon next to Sync Source
Select HighQ
Click Configure Sync
Sign in to HighQ and grant permissions
Select a workspace
Enter or select the folder path
Click Activate Sync
iSheet Reporting
HighQ also supports pushing data from Luminance to HighQ iSheets.
Go to Division Settings → Integration Targets
Add a HighQ integration target
In Luminance Insights, configure a report target
Map Luminance fields to HighQ iSheet columns
Run the report
Note: iSheet reporting is configured separately from document sync
Usage: Expected Behavior
Once the integration is created, users can sync documents from HighQ into any Luminance folder.
Behavior | Details |
Automatic sync | Documents added to the selected HighQ location are automatically synced to Luminance. Sync occurs periodically |
One-directional | Sync from HighQ to Luminance only |
Workspace selection | Users select a workspace during setup. Only accessible workspaces are available |
Folder-scoped | Sync only configured folders |
No delete sync | Documents removed from HighQ are not deleted from Luminance |
Authentication | Require reauthentication when token expires |
Access-dependent | Sync only accessible workspaces |
Security best practices
Use a dedicated API registration
Store the Client Secret securely
Ensure HighQ instance is accessible from Luminance
Log out of HighQ before starting OAuth to avoid session conflicts
Troubleshooting
Use this table to identify and resolve common issues.
Issue | Cause | Resolution |
Failed to obtain access token | HighQ instance not reachable or custom domain restrictions | Verify the HighQ URL is correct and accessible from your network |
OAuth callback error | Redirect URL misconfigured | Verify the redirect URL matches https:///auth/callback or try leaving it empty |
OAuth fails during login | Active HighQ session conflict | Log out of HighQ in all tabs, then retry authentication |
iSheets not working | Reporting not configured | Ensure an integration target is added and report mapping is configured |
Two-factor authentication issues (known limitation) | HighQ 2FA interfering with OAuth | Disable 2FA temporarily during setup or complete authentication in a clean session |
Cannot access workspace | Insufficient permissions | Verify the user has access to the HighQ workspace |
Password-protected sites (known limitation) | Additional security controls | Ensure the site does not require extra authentication steps |
IP restrictions blocking access (known limitation) | Restricted HighQ environment | Ensure the environment allows external access |
Terms and conditions blocking access (known limitation) | Required acceptance step | Log in to HighQ manually and accept any required terms |