Skip to main content
Only admins can create global API tokens. Team leads can view existing ones.

​
Create a global API token

A global API token works across every Better Stack product and team.

1

Create the token

Sign in to your Better Stack account, then go to Settings > API tokens > Global tokens.

  • Token name: StackOne Integration
  • Select Read & write, or Read only for a read-only connection. Webhook events need Read & write.
  • Click Create.
The Global tokens tab with the Token name, access level and Create button highlighted
2

Copy the token

In the StackOne Integration row, click Copy, then paste the API Token into StackOne Hub.

The global token list with the Copy button for the StackOne Integration token highlighted
3

Copy the team name

If your organization has more than one team, go to Settings > Teams and copy the name of the team to work with into StackOne Hub as the Team Name.

  • Example: First Team
  • Leave Team Name empty when your organization has only one team.
  • Webhook events come from this team’s incidents and monitors.
The Teams page with a team name highlighted

​
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:
  • API Token
  • Team Name (Optional)
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 on your Accounts page.

​
Next Steps

Webhooks setup

Configure receiving Events for Better Stack into StackOne.