Create API Auth Token

Returns an API access token specific to the Management API. This token must then be used as an authorization header for all requests to protected endpoints (this is required for the majority of operations).

POST/oauth/token

Request Body

application/json

client_id*string

Use the client_id value provided for authenticating with the Management API authentication provider as part of your on-boarding.

client_secret*string

Use the client_secret value provided for authenticating with the Management API authentication provider as part of your on-boarding.

audience*string

Use the audience value provided as part of your on-boarding for the Management API.

grant_type*string

Use client_credentials.

Response Body

`application/json`

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

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

const body = JSON.stringify({  "client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",  "client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",  "audience": "https://my-tenant.vii.mattr.global",  "grant_type": "client_credentials"})fetch("https://manage.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`