Skip to main content

How to Create a Deeplink

Learn how to create a deeplink that lets users log in through SAML2 and go directly to a specific page in the platform. Step-by-step guide including URL encoding and example links.

TinQwise Service avatar
Written by TinQwise Service
Updated over a week ago

A deeplink lets a user log in through SAML2 and land directly on a specific page in the platform — for example, a module, programme, or reporting page.

It’s especially useful when you want to guide users straight to the right location without them having to navigate through the platform manually.

Follow the steps below to create one:


1️⃣ Start with the SAML2 login link

Begin with your base login URL (the one that already includes the IdP):

https://tinqwise.platform.co.nl/saml2/login/?idp=https://sts.windows.net/0ac19a46-cb75-4a62-b394-d22b6e12258e/

2️⃣ Find the target page link

Navigate to the exact page you want users to land on and copy the full URL.
Example:

https://tinqwise.platform.co.nl/#/module/61a25cf3-4d10-4118-b52d-d6d6d3f902ee/1

For your deeplink, you only need the part starting from /#/:

/#/module/61a25cf3-4d10-4118-b52d-d6d6d3f902ee/1

3️⃣ URL-encode the page path

To make the link work, the platform requires this part to be URL-encoded.
This means replacing special characters with codes:

Character

Encoded version

/

%2F

#

%23

So this path:

/#/module/61a25cf3-4d10-4118-b52d-d6d6d3f902ee/1

becomes:

%2F%23%2Fmodule%2F61a25cf3-4d10-4118-b52d-d6d6d3f902ee%2F1

4️⃣ Add it as the next parameter

Now attach your encoded path to the login link as the &next= parameter:

https://tinqwise.platform.co.nl/saml2/login/?idp=https://sts.windows.net/0ac19a46-cb75-4a62-b394-d22b6e12258e/&next=%2F%23%2Fmodule%2F61a25cf3-4d10-4118-b52d-d6d6d3f902ee%2F1

✅ Final Deeplink

Your complete deeplink is now ready to share!

https://tinqwise.platform.co.nl/saml2/login/?idp=https://sts.windows.net/0ac19a46-cb75-4a62-b394-d22b6e12258e/&next=%2F%23%2Fmodule%2F61a25cf3-4d10-4118-b52d-d6d6d3f902ee%2F1

💡 Tip:
Use any online URL Encoder tool, paste your /#/… path into it, and copy the encoded result.

Did this answer your question?