This document outlines the use of the Unit4 Talent Management API. All possible API requests are documented on

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 pag
  • You will arrive at the Integrations page. Now click the Unit4 TM 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 X-Intuo-Token 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, 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" 

or if you are using the Authorization  header:

curl --header "Authorization: Intuo 036dff5afc17d3cfe759477ba28368d1" --header "accept: application/json; version=1" --header "Content-Type: application/json"

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"

In case you run into problems or have any other questions, do not hesitate to contact us at