Create API Auth Token
Returns an API access token. This token must then be used as an authorization header for all requests to protected endpoints (this is required for the majority of operations).
This request must be made to an authentication server based on your tenant's region:
- Sydney, Australia:
auth.au01.mattr.global
- Montreal, Canada:
auth.ca01.mattr.global
- Frankfurt, Germany, Europe:
auth.eu01.mattr.global
- Oregon, United States:
auth.us01.mattr.global
Your region details as well as required client_id
and client_secret
are provided as part of onboarding, or retrieved when you create a tenant on the Self Service Portal. If you do not have your tenant details, or have any other questions, please contact us before proceeding.
Request
Request Body schema: application/json
Responses
200
Successful response
401
Unauthorized
post/oauth/token
Request samples
- Payload
- curl
- Node.js
- JavaScript
- Python
- C#
- Java
application/json
{- "client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",
- "client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",
- "grant_type": "client_credentials"
}
Response samples
- 200
- 401
application/json
{- "access_token": "s2dgbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6s2dcaEROemRDf5gbRVEwTTVSVFE0TmtZME9UZzVNVEpDTlVJNFJqRTBPREExTmpZMk1qazFPQSJ9",
- "expires_in": 86400,
- "token_type": "Bearer"
}