Skip to main content
Sign in as an Admin of your Twingate network. Only an Admin can generate tokens under Settings > API, and a token belongs to that one network.

Find your Network name

The Network is the host name of your Twingate Admin Console: your network name, then the region when your address has one, then twingate.com.

1

Copy the network host

Sign in to your Twingate Admin Console. The network host is shown under your network name on the Network overview, and in the browser address bar.

  • Format: {network}.{region}.twingate.com or {network}.twingate.com
  • Example: acme.us1.twingate.com
  • Example without a region: acme.twingate.com
  • Keep the region, such as us1, when your host shows one.
  • Leave out the scheme at the start and anything after twingate.com.
  • Paste it into the Network field in StackOne Hub.
The Twingate Network overview with the network host stackone.us2.twingate.com highlighted

Create the API token

A Twingate API token belongs to one network and can do only what its permission level allows.

1

Sign in to Twingate

Sign in to your Twingate Admin Console at https://{network}.twingate.com as an Admin.

  • Navigate to Settings > API.
The Settings menu with API highlighted
2

Start a new token

On the API page, click Generate Token.

The API page with the Generate Token button highlighted
3

Name the token

In the Generate Token window, enter a Label.

  • Label: StackOne Integration
The Generate Token window with the Label field highlighted
4

Choose the permission level

Open Permission Level and pick the level for the actions you plan to use. The levels are nested, so each one includes the ones before it.

  • Read only — Only read requests allowed. Enough for the list and get actions only.
  • Read & Write — Create & modify requests allowed. Needed for the create, update, delete, approve, reject, block and archive actions.
  • Read, Write, & Provision — Generate Connector token requests allowed. Needed to generate Connector tokens and to create Service Account keys, and the only level that covers every action in this connector.
The Permission Level list showing Read only, Read & Write, and Read, Write, & Provision
5

Set allowed ranges and generate

Allowed Ranges defaults to 0.0.0.0/0, ::/0, which allows requests from any address.

  • To limit the token to StackOne, replace the default with StackOne’s IP addresses, separated by commas. A request from any other address fails authentication.
  • Click Generate.
The Generate Token window with Permission Level, Allowed Ranges and the Generate button highlighted
6

Sign in again if asked

Twingate may show Please sign in again to verify your account before it creates the token.

  • Sign in again with the same Admin account. Twingate then creates the token.
  • If the Copy Token window does not open after you sign in, check the token list. When the new token is listed, delete it and click Generate Token again.
The Twingate sign-in page with the message Please sign in again to verify your account
7

Copy the token

The Copy Token window shows the new token. Hover over it, click Copy, and store it securely for use later.

  • The token is shown once and cannot be retrieved later. Copy it before you close the window.
  • Paste it into the API Key field in StackOne Hub.
  • Click Close.
The Copy Token window with the token hidden

Native Webhook URL

The Native Webhook URL field in StackOne Hub is filled in by StackOne after the account is linked. You don’t enter anything in it. It is only needed if you send Twingate notifications to StackOne, as described in the webhook setup guide.

Disable or replace the token

To stop StackOne from using your network, disable the token. You can enable it again later.

1

Disable the token

Navigate to Settings > API and open the menu at the end of the token’s row.

  • Click Disable Token, or Delete Token to remove it for good.
  • To replace the token, generate a new one with the same settings, paste it into the API Key field in StackOne Hub, then disable the old one.
  • Twingate documents no expiry for API tokens, so the connection keeps working until you disable or delete the token or change its allowed ranges.
The token row menu with Edit Details, Disable Token and Delete Token, and Disable Token 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 Twingate into StackOne.