Integrations · Bentley ProjectWise
Bring your own Bentley iTwin app
Register a free application on the Bentley iTwin Developer Portal and connect it to Alloovium. No partner approval required — registration is instant and self-service.
Why this route exists
Unlike some construction platforms that require vendor approval before issuing API credentials, Bentley’s iTwin Platform is fully self-service. Any developer can register an application and start making API calls within minutes.
You create the app in your own Bentley account. Your credentials are private to your tenant in Alloovium and are never shared.
Requirements
- A Bentley account (free). Sign up at developer.bentley.com.
- ProjectWise 365 (cloud) or an on-premises ProjectWise Connection Server with API access enabled.
- About 10 minutes.
Cloud vs On-Premises
This guide covers ProjectWise 365 (cloud). On-premises ProjectWise deployments use an older authentication model. Contact Alloovium support for assisted on-premises setup.1. Register an iTwin application
- 1
Sign in to the iTwin Developer Portal
Go to developer.bentley.com and sign in. If you don’t have an account, click "Register" — it’s free.
- 2
Create a new application
Click "Register new" in My Apps. Give it a name like "Alloovium — Internal". Select "Web App" as the application type.
- 3
Select scopes
Enable these scopes: projectwise:read (read documents and folder structure). You do not need write scopes.
- 4
Add the redirect URI
Add this redirect URI: https://app.alloovium.com/integrations/projectwise/callback
- 5
Save and copy credentials
Save the application. Copy the Client ID — it is shown on the detail page. If the portal offers a Client Secret, copy it too.
2. Grant ProjectWise access
Your iTwin app must be authorised to access your ProjectWise environment.
- 1
Contact your ProjectWise administrator
Send your admin the Client ID and ask them to whitelist it in the ProjectWise Connection Server settings (or in the iTwin organisation settings if using ProjectWise 365 cloud).
- 2
Confirm access
Once whitelisted, your app can read the document store. The admin does not need to share any secrets — only the Client ID is needed for the whitelist.
Protect your Client Secret
Treat the Client Secret like a password. If exposed, rotate it immediately from the iTwin Developer Portal.3. Connect in Alloovium
- 1
Open Alloovium → Integrations → ProjectWise
Navigate to the ProjectWise integration page.
- 2
Enter credentials
Paste your Client ID and Client Secret. Enter your ProjectWise datasource URL if prompted.
- 3
Authorise and select folders
Click Connect. Alloovium will authenticate and show your ProjectWise folder structure. Select the folders to sync.
Troubleshooting
Insufficient permissions error
Ensure the projectwise:read scope is enabled on your iTwin app. ProjectWise datasource-level permissions must also be granted by your server admin.
On-premises server not reachable
On-premises ProjectWise Connection Servers need firewall rules to allow Alloovium’s outbound IPs. Contact your IT department or reach out to Alloovium support for the IP range list.
Account does not have developer portal access
The iTwin Developer Portal is free and does not require a paid Bentley subscription. Register a personal account at developer.bentley.com and create the app there.