Authorization

This tutorial will you walk you through obtaining access to the Management API.

Before you Begin

If you have been provided access to the Management API, you should have been provided with the following credentials:

• client_id: Required for authorization.

• client_secret: Required for authorization.

• environmentId: Required for creating new tenants.

Note: These are not the same client_id and client_secret you were provided for accessing other MATTR VII APIs, but unique credentials for accessing the Management APIs.

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

Obtaining an Access Token

To obtain an API access token, make the following call to the authorization provider using your Management API client_id and client_secret:

Request

1POST https://auth.manage.mattr.global/oauth/token

1{
2  "client_id": "YOUR_CLIENT_ID",
3  "client_secret": "YOUR_CLIENT_SECRET",
4  "audience": "https://manage.mattr.global",
5  "grant_type": "client_credentials"
6}

Response

1{
2  "access_token": "YOUR_ACCESS_TOKEN",
3  "expires_in": 14400,
4  "token_type": "Bearer"
5}

Use the returned access_token as the bearer token for all subsequent requests to the Management API service.

Refer to the authorization section of the API Reference for more information.

What's Next?

You can now use your access token to Manage Tenants.