Security

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.

Request

Request Body schema: application/json

client_id required	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 required	string Use the `client_secret` value provided with your tenant details, or retrieved when you created a tenant on the Self Service Portal.
audience required	string Use your tenant URL.
grant_type required	string Use `client_credentials`.

Responses

200

Successful response

401

Unauthorized

post/oauth/token

Request samples

application/json

{"client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",
"client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",
"audience": "https://learn.vii.au01.mattr.global",
"grant_type": "client_credentials"
}

Response samples

application/json

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

➔ Next to Custom Domain