> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Better Stack with Global API Token – StackOne Hub

> Link a Better Stack account in the StackOne Hub using Global API Token. End-user guide to authorize the integration and start using Better Stack actions.

> [!WARNING]
>
> 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](https://betterstack.com/users/sign-in), then go to **Settings** > **API tokens** > **Global tokens**.

<ul>
  <li>**Token name**: `StackOne Integration`</li>
  <li>Select **Read & write**, or **Read only** for a read-only connection. Webhook events need **Read & write**.</li>
  <li>Click **Create**.</li>
</ul>

![The Global tokens tab with the Token name, access level and Create button highlighted](https://mintcdn.com/stackone-60/KgQIV1ii3tINlPJD/connectors/betterstack/images/custom-config-create-global-token.png?fit=max\&auto=format\&n=KgQIV1ii3tINlPJD\&q=85\&s=19e6d4bf5981ecab993f6dce7aaf7a20)

**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](https://mintcdn.com/stackone-60/KgQIV1ii3tINlPJD/connectors/betterstack/images/custom-config-copy-global-token.png?fit=max\&auto=format\&n=KgQIV1ii3tINlPJD\&q=85\&s=19805fc1ed57f4590d2bbf4856532a75)

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

<ul>
  <li>Example: `First Team`</li>
  <li>Leave **Team Name** empty when your organization has only one team.</li>
  <li>Webhook events come from this team's incidents and monitors.</li>
</ul>

![The Teams page with a team name highlighted](https://mintcdn.com/stackone-60/KgQIV1ii3tINlPJD/connectors/betterstack/images/custom-config-team-name.png?fit=max\&auto=format\&n=KgQIV1ii3tINlPJD\&q=85\&s=273c1da938e2b2653db2c5fdc1081fb5)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/betterstack/guides/webhook-setup.md)
>
> Configure receiving Events for Better Stack into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.