Guides
Platform Management
Retrieve an access token

How to get an access token

Before you can make any API requests to your MATTR VII tenant, you must complete authentication by obtaining an access token from our authentication provider.

Prerequisites

  • Login credentials provided as part of your onboarding process.

    If you have not received these details or have any questions, please contact us before proceeding.

Request

Use your login credentials to make a request of the following structure:

HTTP
POST https://{auth_server}/oauth/token

Note that this URL is different to your tenant_url. auth_url is only used for obtaining an access token, while tenant_url is used for all other requests to your tenant.

JSON
{
    "client_id": "F5qaeLDdbvnU9zhA0j4eHUGCHwC1bKtt",
    "client_secret": "Wzc8J**********************************************************",
    "audience": "learn.vii.au01.mattr.global",
    "grant_type": "client_credentials"
}

Response

JSON
{
    "access_token": "eyJhb********************************************************************",
    "expires_in": 14400,
    "token_type": "Bearer"
}

The returned access_token value must be used as a bearer token for all subsequent requests to protected resources on your tenant.