How to get a management API access token

Before you can make any API requests to manage your MATTR VII tenants, you must complete authentication by obtaining a management API access token from our authentication provider.

Prerequisites

Management API client credentials provided as part of your onboarding process:

• client_id
• client_secret
  These are not the same client_id and client_secret you were provided for accessing other MATTR VII APIs, but rather unique credentials for accessing the Management APIs. If you have not received these credentials or have any questions, please contact us before proceeding.

Request

Use your management API client credentials to make a request of the following structure:

POST https://mattr-management-auth-prod.au.auth0.com/oauth/token

{
    "client_id": "F5qaeLDdbvnU9zhA0j4eHUGCHwC1bKtt",
    "client_secret": "Wzc8J**********************************************************",
    "audience": "https://manage.mattr.global",
    "grant_type": "client_credentials"
}

• client_id : Replace with the client_id value from your management API client credentials.
• client_secret : Replace with the client_secret value from your management API client credentials.
• audience : Always use https://manage.mattr.global as a static value, regardless of your specific management API client credentials.
• grant_type : Always use client_credentials as a static value, regardless of your specific management API client credentials.

Response

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

The returned access_token must be used as a bearer token for all subsequent requests to the management API.