Skip to main content
This guide shows you how to register your own app with simPRO to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their simPRO account. simPRO offers two paths depending on whether you’re integrating against a single build (typical for in-house tooling) or building a public integration distributed to many simPRO customers.

Path 1 — single-build OAuth app (in-house use)

Use this path if you only need to connect to your own simPRO build.
1

Log in to your simPRO build

Go to https://<your-build-name>.simprosuite.com/ and log in with an admin account.
2

Open API Applications

Navigate to System > Setup > Integrations > API > Applications.
3

Create a new application

  1. Click Create Application
  2. Fill in: Company, Name, Email Address
  3. Redirect URI: enter https://api.nango.dev/oauth/callback
  4. Authentication Method: select OAuth 2.0
  5. Grant Type: select Authorisation Code
  6. Click Create
4

Get your credentials

Copy your Client ID and Client Secret from the application detail page (or download the key file simPRO offers on creation). You’ll need these when configuring the integration in Nango.
5

Next

Follow the Quickstart to connect your first account. Note that this app’s credentials only work against the build it was created in — if you need to connect multiple customer builds, see Path 2.

Path 2 — central partner OAuth app (multi-tenant integrations)

Use this path if you’re building a public integration that connects to many simPRO customers’ builds.
1

Sign the Simpro Group Partner Program Agreement

Apply at simprogroup.com/partners and complete the partner programme agreement. You’ll get access to the Simpro Group Partner Network portal at simpro.allbound.com.
2

Submit the integration approval form

From the partner portal, find Integration Approval Process and Technical Guidelines. The PDF describes a 2-phase approval (submit integration name, description, redirect URIs → Simpro reviews → central credentials issued).
3

Specify your Nango callback URL

In the integration approval form, set the redirect URI to https://api.nango.dev/oauth/callback.
4

Receive central OAuth credentials

After approval, the Simpro Group partner team will issue you a central client ID and secret that work across every customer’s simPRO build. Use these in your Nango integration settings.
5

Next

Follow the Quickstart to connect your first customer’s account. Each customer enters their own simPRO build name when authorising.
For more details, see simPRO’s API authentication docs.