Authentication

The Viskan API uses the standardized OAuth protocol to authorize clients. As a part of the Visma Group, Viskan use Visma Connect as the authorization platform.

Example

Authentication request

POST /connect/token

Host: connect.visma.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
scope=viskan:country:read
client_id=isv_my-application
client_secret=yj2...7Qp
tenant_id=db100d69-1081-465e-8fbd-ab3d6b94ba0a

Authentication response

json

{
  "access_token": "eyJhb...XGw",
  "expires_in": 3600,
  "token_type": "Bearer",
  "scope": "viskan:country:read"
}

Calling Viskan API

When you've received your access_token as per the example above, you can use this token in your requests to Viskan API, using the Authorization header, like this:

Authorization: Bearer <access_token>

How do I get client credentials?

You must sign up in Visma Developer Portal. Please refer to the documentation found under "Sign up in Visma Developer Portal".

How do I get access to a specific tenant?

This is also handled via Visma Developer Portal, as well as Visma App Store. You can read more about this in the section "Publish your application".

Authentication ​

Example ​

Authentication request ​

Authentication response ​

Calling Viskan API ​

How do I get client credentials? ​