How to import Motimate Public API Documentation to Postman?

Introduction

If you're an API developer, you know how important it is to test and document your application to ensure its functionality and reliability. Postman is a popular tool among developers as it provides a user-friendly interface to make HTTP requests, test endpoints, and visualize responses.

One of the key features of this tools is the ability to import documentation in Open API format. In this article, we will guide you through the process of importing Motimate Public API documentation (in Open API 3.0 format) into a Postman Collection, making your API testing and development more efficient.

Requirements

Before we start, you will need to have Postman installed on your system. You can download Postman here.

Import Motimate API for Postman Collections:

1. Go to the page for downloading the Motimate Public API documentation (here).
   
   
2. Find the Export button in the top right corner, and click it. Select Download API, then JSON Unresolved.
   
   
3. Once the file has been downloaded, open Postman.
   
   
   
   
4. Open the Collections tab and click Import. Upload the downloaded file as a Collection.
   
   
   
   
5. Time to set up our authorization - click Motimate Public API and then select the Variables tab.
   
   
   
   

6. Add a new variable named clientId and set the Initial value to the value provided by Motimate. The current value will update automatically.
   
   then...
   
   

   Add a new variable named clientSecret and set the Initial value to the value provided by Motimate. The current value will update automatically.
   
   
   
   

7. Very important: Click Save!
   
   
   
   
8. Click Motimate Public API again and select the Authorization tab.
   
   
   
   

9. Set Type to OAuth 2.0. A form should appear. Scroll down to the Configure New Token section.

   If you see “Some changes to the Token…” info, simply click Edit Token Configuration.
   
   
   
   

10. Set Grant type to Client Credentials:

    1. Set Access Token URL to {{baseUrl}}/oauth/token

    2. Set Client ID to {{clientId}}

    3. Set Client Secret to {{clientSecret}}
       
       
       
       

11. Scroll down and click Get New Access Token. Postman should inform you about an successful authentication. Click Proceed and then Use Token.
    
    

12. Very important: Click Save!
    
    

13. Click: me → fetch Current Organization → Send.

    You should see a response from the Motimate Public API, with your organization data.
    
    
    
    

    Congratulations! You have now imported the Motimate Public API to Postman Collections 🎉