Netilion Connect

Build your own integration

You can use the following guide step by step for the first setup.

Create a connect subscription

Once logged into Netilion ID, go to
Profile > Subscriptions > Netilion Connect.
When logged into another Netilion application, first click on your user name, then navigate to Profile from there.

Here you have the option to create a connect subscription. Either start off with a free plan to play around or dive in with one of our pro-plans.

Specify an application name for your reference and set your redirect uri.
Read more about redirect uris in the API Authentication section.

After creating your subscription you are on the subscription details page.

Create an API key

From the subscription details page you can create API keys for your application. Choose OAuth 2.0 as type.

Create a technical user

From the subscription details page you can create technical users for your application. The password will only be displayed once. You can then reset the password or delete the user.

Grant user permissions

To grant permissions to your technical users click on permissions.
Now select the Netilion objects (nodes, tags or assets) that the technical user should have access to. You grant the permission on the edit page of each object.

One option is to click on the three dot menu that is displayed for all objects in the list.
Alternatively you can navigate to the details page of an object, then click on
Edit > Permissions > Add User and enter the technical user’s email address.

Tick the read / update / delete boxes to define precise permissions.
You can always come back and manage permissions on all your Netilion objects from the subscription details page.

Read more on permissions design in the permissions section.

Besides this UI, the Netilion API offers specific endpoints to maintain permissions. Find the details in the API documentation.