This document outlines the use of the intuo API. All possible API requests are documented on https://intuo.readme.io/reference

Before you can send a request, you will need an API token. In order to generate a token, you will need admin permissions on your platform:

  • Login to your platform as an admin
  • Click the settings cog at the bottom of the page
  • Click the Integrations tab at the top of the page
  • You will arrive at the Integrations page. Now click the Intuo tab at the top of the page.
  • You will see a section called API Tokens. You can generate a token here.

Once you've generated your token (e.g. 036dff5afc17d3cfe759477ba28368d1 ), you will be able to issue API requests. Each API request needs at least the following headers:

  • X-Public-Token  or Authorization - the value of this header should be your API token (in the case of X-Public-Token  and Intuo your_token  in the case of the Authorization  header) 
  • Accept  - indicate that you are requesting a JSON resource with the version of the API you want to target (version 1)
  • Content-Type  - indicate that you are sending JSON content with your request
  • (Optionally) if you wish to make requests to api.intuo.io, you'll also need the X-Subdomain  header, which has to have your subdomain as a value

For example, a cURL request for your users on platform example  with the above API token would look like this if you are using the X-Public-Token  header:

curl --header "X-Public-Token: 036dff5afc17d3cfe759477ba28368d1" --header "accept: application/json; version=1" --header "Content-Type: application/json" https://example.intuo.io/public/courses 

or if you are using the Authorization  header:

curl --header "Authorization: Intuo 036dff5afc17d3cfe759477ba28368d1" --header "accept: application/json; version=1" --header "Content-Type: application/json" https://example.intuo.io/public/courses

or if you are using the X-Subdomain  header:


curl --header "X-Public-Token: 036dff5afc17d3cfe759477ba28368d1" --header "accept: application/json; version=1" --header "Content-Type: application/json" --header "X-Subdomain: example" https://api.intuo.io/public/courses


In case you run into problems or have any other questions, do not hesitate to contact us at support@intuo.io.

Did this answer your question?