Auth Link

Get your customer to connect their tool with only a link!


Auth Links allow you to deliver a secure URL to your end users that integrates them seamlessly, giving them a secure, in-browser experience without requiring any frontend code.

This feature enables a fast proof of concept using StackOne.

How to generate a link

An Auth Link can be generated directly from the StackOne dashboard. Here's how:

  1. Log in to the StackOne dashboard and select Accounts from the left menu.

  2. Press the πŸ”— Create Auth Link button on the right hand-side

  1. Fill in the required fields into the Create Auth Link modal:

    • Origin owner ID - this should be the customer identifier you use in your own system(s) (most likely, a UUID or integer)

    • Origin owner name - this is the Customer Name in your own system(s)

    • (optional) Origin username - your customers' user (eg: an email address) that will connect or be responsible for the connection of the system

    • (optional) Category - If you have enabled integrations across multiple category - you can filter the list of connector displayed
      Make sure that the information you enter matches your system precisely. Then click on Create Link.

  2. A unique Auth Link is then generated. Copy and send this to your customer.

πŸ“Note: This link expires after 5 days.

What does the receiving user see?

When the user clicks on the Auth Link, they will see the StackOne Integrations Hub with a list of all integrations enabled on your project. The user can then select the provider they want to connect and will be prompted to fill out their authorization details.

Verifying the Connection

After the user has completed their authentication and connected successfully, Stackone will fire a account.created webhook event containing the Account ID (which you will need to successfully make a unified API request. The linked account will also be displayed in the accounts page and it will also be visible via the Accounts API endpoint.