Skip to content
  • There are no suggestions because the search field is empty.

ISOPlanner API with Postman or Insomnia

In this guide, we’ll give you a basic overview of how to make your first requests to the ISOPlanner API using two API testing tools – Postman and Insomnia.

If you prefer to use a different tool, you can always import our Open API 3 specification file to your tool of choice. Keep in mind that we’ll occasionally update our Open API 3 specification file, so you might need to re-import it from time to time.

Important: the examples below authorizes using your personal Microsoft account for testing. For production purposes, we advice to use a Service Principal.

 

ISOPlanner API with Postman

Setup

If you don’t have Postman yet, start by downloading and installing it from https://www.getpostman.com/downloads. Now Import the Open API 3 specification file.

Authorization

Setup authorization on the root level of the Collection.

  • Type: OAuth 2.0
  • Add auth data to: Request headers
  • Header prefix: Bearer
  • Grant type: Authorization code (With PKCE)
  • Callback URL: Check Authorize using Browser
  • Auth URL: https://login.microsoftonline.com/common/oauth2/authorize/
  • Access Token URL: https://login.microsoftonline.com/common/oauth2/token/
  • Client ID: 2a2fc0d2-c9ab-4e14-9d0b-79618085e85e
  • Code Challenge Method: SHA-256
  • Scope: access_as_user
  • Client Authentication: Send client credentials in body
  • Advanced / Token Request: Add key Resource with Value api://9a056f37-32fc-48b0-8075-e032dec8e3ac

 

Now you can make your first requests.

ISOPlanner API with Insomnia

Setup

If you don’t have Insomnia yet, start by downloading and installing it from https://insomnia.rest/download. Now Import the Open API 3 specification file.

Authorization

  • Type: OAuth 2
  • Grant type: Authorization code
  • Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize/
  • Access Token URL: https://login.microsoftonline.com/common/oauth2/token/
  • Client ID: 2a2fc0d2-c9ab-4e14-9d0b-79618085e85e
  • Use PKCE: Yes
  • Code Challenge Method: SHA-256
  • Credentials: In Request Body
  • Resource: api://9a056f37-32fc-48b0-8075-e032dec8e3ac

 

Now you can make your first requests.

 

Resources

  • Using a Service Principal to create a token for ISOPlanner