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

Check that you are an administrator
Only an administrator can create a token that StackOne accepts, because StackOne reads every user of the account.
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.

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.
Open your token settings
Click User Settings in the left navigation, then open Personal access token under
Security.
- You can also open the Personal Access Token page directly.

Add the token
sipgate asks for a name first, then the scopes, then shows the token once.
Start a new token
Click Add at the top right of the Personal Access Token page.

Name the token
On Add token, fill in Token name, then click Continue.
- Any name you recognise works, for example
StackOne Integration.

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:readlists the users and tells StackOne which of them is an admin.groups:readlists the groups.groups:users:readlists the members of each group. StackOne checks it as soon as the account has a group.channels:readlists 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:readonly 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.

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

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.
Link the Account
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.
Use Actions