Skip to main content
Only an Owner, Admin, IT admin or Network admin can generate an API access token. The token has the same permissions as the user who generates it, and Tailscale offers no scopes to narrow it, so it can also change users. The OAuth 2.0 option limits access with scopes.

Generate the API access token

An API access token, sometimes called an API key, carries the permissions of the user who generates it.

1

Sign in to Tailscale

Sign in to your Tailscale admin console as an IT admin.

  • IT admin is the smallest role that covers this connector. It reads users and the policy file and manages users, invitations and devices. It cannot change the policy file, DNS or billing.
  • If your plan has no IT admin role, sign in as an Admin.
  • Do not use a Network admin. Tailscale lets only an Owner, Admin or IT admin manage invitations, and the connection test lists pending invitations.
  • Open the Keys page under Settings.
  • In the API access tokens section, select Generate access token….
Keys page with the Generate access token button highlighted
2

Set the description and expiration

In the Generate API access token dialog, enter a Description you will recognize, such as StackOne Integration. Set Expiration to the number of days the token stays valid, then select Generate access token.

  • Tailscale accepts 1 to 90 days.
  • When the token expires, the connection stops working until you paste a new token into StackOne Hub. Set a reminder to replace it before then.
Generate API access token dialog with Description, Expiration and the Generate access token button highlighted
3

Copy the token

In the Generated new key dialog, copy the token with the copy button, store it securely for use later, then select Done.

  • The token is only displayed once and cannot be retrieved later. If you do not copy it, generate a new token.
  • The token starts with tskey-api and is case-sensitive.
  • Paste it into the API Access Token field in StackOne Hub.
Generated new key dialog with the copy button highlighted and the token masked

Revoke the token

To stop StackOne from reading your tailnet before the token expires, revoke it.

1

Select Revoke

On the Keys page, in the API access tokens section, select Revoke… next to the token.

API access tokens list with Revoke highlighted for one token
2

Confirm the revocation

Select Revoke key.

  • Recently expired and revoked tokens stay listed on the Keys page.
Revoke dialog with the Revoke key button highlighted
1

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.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Next Steps

Webhooks setup

Configure receiving Events for Tailscale into StackOne.