Create API Auth Token

POST/oauth/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.

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`

curl --request POST \  --url https://auth.mattr.global/oauth/token/ \  --header 'Content-Type: application/json' \  --data '{"client_id": "KWdv9qo9Vnl9rrCRB7sfGKFTp4uO09im",           "client_secret": "ztJe2GVpOb1_rUo9Vnl9rrCRB7sfGKFTp4uO0DOfLnA5FSz96wbrzgJMQ",           "audience": "https://learn.vii.au01.mattr.global",           "grant_type": "client_credentials"          }'

{
  "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`