All our webservices use session based authentication through our Authenticate webservice. To improve performance and ease the stress on our servers, you should store the sessionId on your side so you don't authenticate unnecessarily. If you repeatedly authenticate with the same credentials, your requests will be throttled.

The SessionId is added to a cookie with the name “ASP.NET_SessionId” and sent to every webservice that you use.

AuthenticateService WSDL

Data types


To authenticate you use the Login-method with a Credential object. Mandatory fields are: ApplicationId, Username and Password. IdentityId does not need to be set, but can be used to control which Identity the login defaults to. Username is always an email address


Here we provide code examples for authenticating: C# .NETPHP.

If the login was successful you will get a Login Response containing your SessionId:

    <LoginResponse xmlns="">

Sessions, identities and community users

There are some important concepts that you need to be familiar with. When you have done a successful request to Login, you will get a SessionId in return. This SessionId is linked to a default Identity. In an integration you need to have some interaction with your user to make sure that the integration uses the correct Identity. You need to make a request to GetIdentities in order to get a list of available Identities for a given session. You then have to present this list to your user. The relevant information for the user is the Name of the Client


Once the user has chosen a client and it is not the current or default client, you need to switch the Identity.

Switching Identities

Your community user has a default identity when you log in. If there are several Identities associated with your community user, you invoke the GetIdentities method to get a complete list. Now you may switch to another Identity by using SetIdentity (pass the whole Identity object) or SetIdentityById (pass the Identity Guid). You may also set the Identity directly in your requests to Login by using the IdentityId property.


Please note: The IdentityId can change, so you should always implement checks to see which Identity is currently active. The IdentityId can change if an Identity is removed and then readded to a community user.

Adding Identities

In order to add identities you need to log in and add them manually by clicking on your company name in the top right corner, then entering firm and user credentials that have been provided to you either from our support or from your customer.


Method Input Type Return type Description
Login Credential string Authenticates the user and returns the session ID
HasSession - bool Returns whether or not the current session is valid
GetIdentities - identity[] Returns a list of community Identities
SetIdentity identity bool Sets a current identity
SetIdentityById identity bool Sets a current identity by its Guid
GetIdentity - identity Returns the current identiy
AuthenticateByToken Token Passport Authenticates with the given token and returns the passport.