Skip to main content
Create the token while signed in as an administrator of the sipgate account. sipgate has two roles, admin and user, and StackOne refuses a token whose owner is not an admin, because it reads every user of the account. The token is shown only once, right after it is created.

Find your sipgate account type

sipgate runs two products, sipgate classic and sipgate neo. Both sign in at the same address and use the same token, so this only tells you which product you are on.

1

Open the profile menu

Sign in to your sipgate account and click your user avatar at
the top right.

  • The menu names your product under your account number, as sipgate neo or sipgate classic.
  • Either product works. StackOne reads groups and channels together, because a classic account can have both and neo uses channels.
The sipgate profile menu with the product name highlighted under the account number

Check that you are an administrator

Only an administrator can create a token that StackOne accepts, because StackOne reads every user of the account.

1

Check your role in the user list

Open the profile menu, click Account Management, then open Telephony > Users.

  • The list shows Admin under the name of every administrator.
  • If your name has no Admin badge, ask an administrator to create the token and send you both values.
The Users list in Account Management with the Users menu item and the Admin badge highlighted

Open the Personal Access Token page

A Personal Access Token is a token ID and token pair that replaces a username and password for the sipgate REST API. It reads the one account it was created in.

1

Open your token settings

Click User Settings in the left navigation, then open Personal access token under
Security.

The Security section of User Settings with the Personal access token row highlighted

Add the token

sipgate asks for a name first, then the scopes, then shows the token once.

1

Start a new token

Click Add at the top right of the Personal Access Token page.

The Personal Access Token page with the Add button highlighted
2

Name the token

On Add token, fill in Token name, then click Continue.

  • Any name you recognise works, for example StackOne Integration.
The Add token dialog with the Token name field filled in and the Continue button highlighted
3

Select the scopes

On Choose OAuth2 scopes, type each scope below into Search scope and tick it, then click Create token. StackOne only reads.

  • users:read lists the users and tells StackOne which of them is an admin.
  • groups:read lists the groups.
  • groups:users:read lists the members of each group. StackOne checks it as soon as the account has a group.
  • channels:read lists the channels, which are the groups on sipgate neo.
  • The counter beside Scopes shows how many you have ticked, so check it reads 4 before you continue.
  • Add account:read only if you also use the Get Account action, which reads the company and contact details of the account. The user, role and group reads do not need it.
  • Leave every other scope unticked. Do not tick all, which grants full access and every future scope.
  • If one of these scopes is missing, StackOne refuses the connection. Add a new token that has all four, then paste the new values into StackOne Hub.
The Choose OAuth2 scopes dialog with the Search scope box, a ticked scope and the Create token button highlighted

Copy the token into StackOne Hub

Save token shows both values once, each with a Copy button beside it. sipgate never shows the token again.

1

Copy both values

Click Copy beside each value, then paste them into StackOne Hub.

  • Paste Personal Access Token ID into the Token ID field.
  • Paste Personal-Access-Token into the Token field.
  • Format: the token ID starts with token-, and the token is 36 letters, digits and hyphens
  • Example: token ID token-FQ1V12
  • Tick I saved the created token, then click Close. If you lose the token before you paste it, add a new one — it cannot be shown again.
  • The token ID stays visible on the Personal Access Token page under Token-ID.
The Save token dialog with a Copy button highlighted beside each of the two values

Know how long the token lasts

sipgate does not ask for an expiry date when you add the token.

  • To stop StackOne from reading your account, delete the token on the Personal Access Token page.
  • After a delete, the connection stops working until you paste a new token ID and token into StackOne Hub.
  • If the person who added the token is no longer an administrator, StackOne refuses the token when it reads users. Create a replacement token and paste the new values into StackOne Hub.
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.