Skip to main content

​
Overview

To authenticate with Simpro, you will need:
  1. Simpro Build Name - The subdomain part of your Simpro URL (e.g. <your-build-name> for <your-build-name>.simprosuite.com).
This guide will walk you through finding your Simpro Build Name so you can complete the OAuth connection.

​
Prerequisites:

  • You must have access to a Simpro Premium build.
  • You must have administrator access if you are connecting your own build via a single-tenant OAuth application. (Multi-tenant partner OAuth apps do not require admin access on each customer build.)

​
Instructions:

​
Step 1: Find your Simpro Build Name

  1. Log in to your Simpro Premium build in a web browser.
  2. Look at the URL in your browser’s address bar. It will be in the form:
    • https://<your-build-name>.simprosuite.com/...
  3. Your Simpro Build Name is the subdomain — everything before .simprosuite.com.
    • Example: for the URL https://acme.simprosuite.com/jobs, the Build Name is acme.
  4. Enter this value (without https:// and without .simprosuite.com) when prompted.
If you manage multiple Simpro builds, each build has its own subdomain and requires a separate connection.

​
Step 2: Enter credentials in the Connect UI

Once you have your Simpro Build Name:
  1. Open the form where you need to authenticate with Simpro.
  2. Enter your Simpro Build Name.
  3. Click Authorize and sign in to Simpro to complete the OAuth flow.
You are now connected to Simpro.