Create API Auth Token

Authorization endpoint for gaining token used for API requests requiring bearerAuth.

You will be provided the required client_id and client_secret as part of onboarding.

The returned bearer token will only enable access to endpoints as per your client's defined role. Refer to Access Control for more information.

POST/oauth/token

Request Body

application/json

client_id*string

Use the client_id value provided with your tenant details, or retrieved when you created a tenant on the Self Service Portal.

client_secret*string

Use the client_secret value provided with your tenant details, or retrieved when you created a tenant on the Self Service Portal.

audience*string

Use your tenant URL.

grant_type*string

Use client_credentials.

Response Body

`application/json`

const body = JSON.stringify({
  "client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",
  "client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",
  "audience": "https://learn.vii.au01.mattr.global",
  "grant_type": "client_credentials"
})

fetch("https://example.vii.au01.mattr.global/oauth/token", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body
})

const body = JSON.stringify({  "client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",  "client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",  "audience": "https://learn.vii.au01.mattr.global",  "grant_type": "client_credentials"})fetch("https://example.vii.au01.mattr.global/oauth/token", {  method: "POST",  headers: {    "Content-Type": "application/json"  },  body})

{
  "access_token": "s2dgbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6s2dcaEROemRDf5gbRVEwTTVSVFE0TmtZME9UZzVNVEpDTlVJNFJqRTBPREExTmpZMk1qazFPQSJ9",
  "expires_in": 86400,
  "token_type": "Bearer"
}

{
  "error": "access_denied",
  "error_description": "Unauthorized"
}

Create API Auth Token

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`