GuidesPlatform managementTenant managementGet management API access token

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:

HTTP
POST https://mattr-management-auth-prod.au.auth0.com/oauth/token
JSON
{
    "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

JSON
{
    "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.