Authentication

Most of the MATTR VII endpoints are protected and require providing a bearer access token when making a request. Before you can make any API requests to a protected endpoint, you must complete authentication by obtaining an access token from our authentication provider.

Whenever you create a tenant or a client for an existing tenant (either via an API request or via the MATTR Portal), you will receive a set of credentials that you will use to obtain an access token. These credentials are unique to the client, the tenant and the roles and permissions assigned to the client when it was created.

Client access credentials

{
    "audience": "https://learn.vii.au01.mattr.global",
    "auth_url": "https://auth.au01.mattr.global",
    "tenant_url": "https://learn.vii.au01.mattr.global",
    "client_id": "2qPIfSHqWyQfShvWc3LmsKIXqPWgMjWT",
    "client_secret": "xfVQi**********************************************************"
}

• audience : Your audience URL. You will use it when you obtain an access token
• auth_url : Your authentication URL. You will make a request to this URL to obtain an access token.
• tenant_url : Your tenant url. You will use this when making any requests to your tenant.
• client_id : Your client identifier. You will use it when you obtain an access token.
• client_secret : Your client secret. You will use it when you obtain an access token.

Additional resources

Creating tenants

Creating clients