> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to register your own Simpro OAuth app

> Register an OAuth app with Simpro and connect it to Nango

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*](https://nango.dev/docs/getting-started/quickstart.md) 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](https://www.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*](https://nango.dev/docs/getting-started/quickstart.md) 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](https://developer.simprogroup.com/apidoc/?page=3366d2ea7906f693b27d57ed9cca3acb#tag/Authorisation-code-grant-workflow).

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.