---
title: ISOPlanner API with Postman or Insomnia
description: 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
---

[Skip to content](https://docs.isoplanner.app/dev-isoplanner-api-with-tools#main-content)

[![ISOPlanner 2000x500 transparent no shadow](https://docs.isoplanner.app/hs-fs/hubfs/ISOPlanner%202000x500%20transparent%20no%20shadow.png?width=200&height=50&name=ISOPlanner%202000x500%20transparent%20no%20shadow.png)](https://isoplanner.app)

Open main navigation

Close main navigation

 How can we help you?

- There are no suggestions because the search field is empty.

1. [ISOPlanner](https://docs.isoplanner.app/)
2. [Developer](https://docs.isoplanner.app/developer)

# 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](https://www.postman.com/downloads/) and [Insomnia.](https://app.insomnia.rest/)

If you prefer to use a different tool, you can always import our [Open API 3 specification file](https://isoplanner.app/wp-content/uploads/2023/08/isoplanner-openapi-svc.json) 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](https://www.getpostman.com/downloads/). Now Import the [Open API 3 specification file.](https://isoplanner.app/wp-content/uploads/2023/08/isoplanner-openapi-svc.json)

#### Authorization

Setup authorization on the root level of the Collection.

![](https://docs.isoplanner.app/hs-fs/hubfs/Knowledge%20Base%20Import/postman1.png?width=1053&name=postman1.png)

- **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](https://insomnia.rest/download/). Now Import the [Open API 3 specification file.](https://isoplanner.app/wp-content/uploads/2023/08/isoplanner-openapi-svc.json)

#### Authorization

![](https://docs.isoplanner.app/hs-fs/hubfs/Knowledge%20Base%20Import/insomnia1.png?width=909&name=insomnia1.png)

- **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

- [Getting Started](https://docs.isoplanner.app/getting-started)
- [Main Concepts](https://docs.isoplanner.app/main-concepts)
- [Common Elements](https://docs.isoplanner.app/common-elements)
- [Administration Menu](https://docs.isoplanner.app/administration-menu)
- [FAQ](https://docs.isoplanner.app/faq)
- [Videos](https://docs.isoplanner.app/videos)
- [Apps & Add-ins](https://docs.isoplanner.app/apps-add-ins)
- [Automated Control Monitoring](https://docs.isoplanner.app/automated-control-monitoring)
- [Developer](https://docs.isoplanner.app/developer)
- [Power Automate](https://docs.isoplanner.app/power-automate)
- [Power BI](https://docs.isoplanner.app/power-bi)
- [Release Notes](https://docs.isoplanner.app/release-notes)
- [Transition Guides](https://docs.isoplanner.app/transition-guides)

[![ISOPlanner 2000x500 transparent no shadow](https://docs.isoplanner.app/hs-fs/hubfs/ISOPlanner%202000x500%20transparent%20no%20shadow.png?width=200&height=50&name=ISOPlanner%202000x500%20transparent%20no%20shadow.png "ISOPlanner 2000x500 transparent no shadow")](https://docs.isoplanner.app/)

[mailto:support@isoplanner.app](mailto:support@isoplanner.app) <https://www.linkedin.com/company/isoplanner/>

Copyright © 2026, ISOPlanner