Get started with Monitask API

Important: Before attempting to access Monitask API, please request API access via [email protected] with the subject “API Access.” API access must be requested by company administrators and can be assigned to any user within the organization.

Steps to get started with Monitask API: 

  1. Navigate to the https://app.monitask.com/developer (developer) page and click “Add new app” button. 
  1. You will be redirected to application registration page where you’ll need to specify basic details for your app: 
Graphical user interface, application, Teams
Description automatically generated

Fill App Name and Redirect Uri, optionally fill Logo Uri and Website Uri and click Create

  1. Now you are redirected to the app details page. You will also be able to access it from developer page later 
Graphical user interface, application
Description automatically generated

Here you can manage redirect uris, scopes and secrets of your app 

  1. Click Add Secret button 
Graphical user interface, text, application
Description automatically generated

Then copy it and save securely. You will not be able to obtain this secret again 

  1. Add openid scope and click Save 
Graphical user interface, text, application
Description automatically generated
  1. Copy Client Id from this page 
Graphical user interface, text, application, Teams
Description automatically generated
  1. Then, you can build an OAuth URL with the following structure: 

 https://app.monitask.com/identity/connect/authorize?client_id=<yourclientid>&scope=<your_scopes> &response_type=code&redirect_uri=<your_redirect_uri> 

Example of such URL: 

https://app.monitask.com/identity/connect/authorize?client_id=437bfbf0d2fd41479e671cdf643aa5ad&scope= profile%20email%20openid%20offline_access%20ExternalApi&response_type=code&redirect_uri=http://localhost:5000/monitask/callback 

  1. When you open this URL you will see a Monitask sign in page: 
Graphical user interface, application, Teams
Description automatically generated

Sign in to your account 

You will be redirected to your application permissions page: 

Graphical user interface, application, Teams
Description automatically generated

Click Yes, Allow 

  1. You are redirected to the specified redirect_url with oauth code: 
  1. You can make an HTTP POST request to the https://app.monitask.com/identity/connect/token with the following data: 

Basic Auth. Username is your client_id, Password is your client_secret 

Graphical user interface, text
Description automatically generated

Body is form-urlencoded with grant_type=authorization_code, redirect_uri is your redirect_uri and code is the code you obtained in oauth dance 

A screenshot of a computer
Description automatically generated with medium confidence

When you execute this request you obtain access_token and refresh_token 

A screenshot of a computer screen
Description automatically generated with medium confidence
  1. You can use obtained access_token for querying our API: 

Add it as a bearer authorization to your request 

A screenshot of a computer
Description automatically generated with medium confidence
  1. Since access token expires after 1 hour, you need to refresh it using the refresh token. To do so, you can use the refresh_token you obtained in the previous “token” request: 
  1. You’ll need to make a request to https://app.monitask.com/identity/connect/token 

With the same basic auth but with the following body: 

Grant_type=refresh_token 

Redirect_uri is your redirect uri 

Refresh_token is refresh token you received before 

Graphical user interface
Description automatically generated

When request is executed you will obtain new access and refresh tokensA screenshot of a computer
Description automatically generated with medium confidence 

Table of Contents