> ## 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 OAuth 2.0 – StackOne Hub

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

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Link your Better Stack account

You sign in to Better Stack and approve access when you link the account.

**1. Grant full access**

Enables actions: Acknowledge Incident, Create A Dashboard, Create A Dashboard Alert, Create A Dashboard Group, Create A Heartbeat, Create A Release, Create A Source, Create A Source Group, Create An Application, Create An On-call Schedule, Create An On-call Schedule Event, Create Catalog Attribute, Create Catalog Record, Create Catalog Relation, Create Comment, Create Escalation Policy, Create Heartbeat Group, Create Incident, Create Monitor, Create Monitor Group, Create Severity, Create Status Page, Create Status Page Report, Create Status Page Resource, Create Status Update, Escalate Incident, Get A Heartbeat's Availability Summary, Get A Single Alert, Get A Single Application, Get A Single Catalog Record, Get A Single Dashboard, Get A Single Dashboard Group, Get A Single Heartbeat, Get A Single On-call Schedule Event, Get A Single Release, Get A Single Source, Get A Single Source Group, Get An On-call Schedule Rotation, Get Catalog Attribute, Get Catalog Relation, Get Comment, Get Escalation Policy, Get Heartbeat Group, Get Incident, Get Monitor, Get Monitor Group, Get On-call Schedule, Get Severity, Get Severity Group, Get Status Page, Get Status Page Report, Get Status Page Resource, Get Status Update, List All Alerts, List All Applications, List All Dashboard Groups, List All Dashboards, List All Releases, List All Source Groups, List All Sources, List Catalog Attributes, List Catalog Records, List Catalog Relations, List Comments, List Escalation Policies, List Heartbeat Groups, List Heartbeats, List Incident Timeline, List Incidents, List Metadata, List Monitor Groups, List Monitors, List Monitors In Group, List On-call Schedule Events, List On-call Schedules, List Severities, List Severity Groups, List Status Page Reports, List Status Page Resources, List Status Page Sections, List Status Pages, List Status Updates Per Report, Monitor Availability, Monitor Response Times, Remove A Dashboard, Remove A Dashboard Group, Remove A Release, Remove A Source, Remove A Source Group, Remove An Alert, Remove An Application, Remove Catalog Attribute, Remove Catalog Record, Remove Catalog Relation, Remove Comment, Remove Escalation Policy, Remove Heartbeat, Remove Heartbeat Group, Remove Incident, Remove Monitor, Remove Monitor Group, Remove On-call Schedule, Remove On-call Schedule Event, Remove Severity, Remove Status Page, Remove Status Page Report, Remove Status Page Resource, Reopen Incident, Resolve Incident, Update A Dashboard, Update A Dashboard Group, Update A Source, Update A Source Group, Update An Alert, Update An Application, Update An On-call Schedule, Update Catalog Attribute, Update Catalog Record, Update Catalog Relation, Update Comment, Update Escalation Policy, Update Heartbeat, Update Heartbeat Group, Update Metadata, Update Monitor, Update Monitor Group, Update On-call Schedule Event, Update Severity, Update Status Page, Update Status Page Report, Update Status Page Resource

When Better Stack asks what access to give, choose **Full access** so actions that create or change resources work. Webhook events also need **Full access**.

<ul>
  <li>
    read
  </li>

  <li>
    write
  </li>
</ul>

**2. Copy the team name**

If you belong to more than one Better Stack 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 you belong to 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/oauth2-config-team-name.png?fit=max\&auto=format\&n=KgQIV1ii3tINlPJD\&q=85\&s=c91d098b2b03d0dff4621b35bc99de87)

## Linking the Account from the Hub

**1. Navigate to the Hub**

Use one of the three [Linking Account Methods](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md) to access the Hub.

**2. Fill out the fields**

Fill out the following fields using details from your provider:

<ul>
  <li>**Team Name** (Optional)</li>
</ul>

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

If the account linking is successful, you will see the newly linked account on your [Accounts](https://app.stackone.com/accounts) page.

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