Skip to main content
The authentication token is shown only once, right after you create it. Copy it immediately and store it somewhere safe — RT will not let you view it again. If you lose it, create a new token. Auth tokens require RT 5.0 or newer.

​
Connect Request Tracker with an authentication token

StackOne connects to your self-hosted Request Tracker (RT) instance using two values: your Instance URL and an authentication token created inside RT. You will sign in to RT, create the token under your account settings, and paste both values into StackOne Hub.

1

Sign in to Request Tracker

Open your organization’s RT instance in a browser and sign in with your RT username and password on the Login screen. Your account needs permission to see and act on the tickets, queues, and users you want StackOne to access — the token inherits your own permissions.

  • Your Instance URL is the base address of your RT instance shown in the browser address bar, without a trailing slash.
  • Format: https://{your-rt-host}
  • Example: https://rt.example.com
  • Paste this value into the Instance URL field in StackOne Hub.
The Request Tracker Login screen with the Username, Password, and Login fields highlighted
2

Open your authentication tokens

In the top-right corner, open the menu showing your name, then go to Settings → Auth Tokens. This opens the My authentication tokens page, which lists your existing tokens. Click Create to add a new one.

The My authentication tokens page with the Create button highlighted
3

Create the authentication token

In the Create authentication token dialog, enter your account password in the current-password field, then type a Description so you can recognize the token later (for example, StackOne). Optionally tick Set Expiration Date to choose an expiry; leave it unchecked for a non-expiring token. Click Create.

The Create authentication token dialog showing the current password field, Description field, Set Expiration Date option, and Create button
4

Copy the token into StackOne Hub

RT shows the message Authentication token created with your new token value. Copy the token immediately — this is the only time it is displayed.

  • The token is shown only once and cannot be retrieved later — copy it before leaving the page.
  • This is your API Token — paste it into the API Token field in StackOne Hub.
  • RT states you must save it now because you cannot access it again; if you lose it, create a new token.
The Authentication token created message with the new token value redacted

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Instance URL
  • API Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.