> ## 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 BrowserStack with API Key – StackOne Hub

> Link a BrowserStack account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using BrowserStack actions.

> [!WARNING]
>
> The [BrowserStack Enterprise API](https://www.browserstack.com/docs/enterprise/api-reference/introduction) needs the Enterprise plan, and BrowserStack lets only members with the Owner or Admin role use it. StackOne reads and manages users and teams through the Users and Teams APIs, which BrowserStack opens only on request. Ask [BrowserStack Support](https://www.browserstack.com/contact) to enable them for your organization before you connect, or the connection test fails.

## Choose whose key to use

The username and access key belong to one BrowserStack member, and StackOne acts with that member's role.

<ul>
  <li>Use a Group Admin, BrowserStack's name for a member whose **IAM Role** is **Admin** for the whole organization rather than for one team. BrowserStack says an Admin can modify product access for other members, invite and remove members, and change member roles.</li>
  <li>An Owner also works. There is one Owner per organization. The Owner adds subscription changes, which StackOne does not use, and can read the audit log without the setting below.</li>
  <li>Do not use a Team Admin. A Team Admin reaches only its own team's members, so StackOne would see part of the organization. The connection test fails when the key cannot see the Owner, but it cannot tell when a Team Admin's team includes the Owner.</li>
  <li>BrowserStack documents one access level for the Users and Teams APIs, Owner or Admin, and names no read-only key. The actions that create, change or remove users and teams use the same key. If auto user provisioning is on, BrowserStack sends team creation and deletion to your identity provider instead.</li>
  <li>Use an Admin who will stay. BrowserStack says a removed member can no longer access the organization's information, so the connection stops working. BrowserStack also suggests resetting access keys when members leave the organization.</li>
  <li>The audit log read is the only action that needs more. BrowserStack lets only the Owner view audit logs by default. To let a Group Admin read them, the Owner opens [Settings > Permissions](https://www.browserstack.com/accounts/settings/permissions), selects the **IAM roles** tab, selects **Allow Group Admins to view Audit logs** under **Account Insights and Reports**, and selects **Save**. Skip this if you do not need the audit log read.</li>
</ul>

## Find your username and access key

The username and access key identify the BrowserStack member who owns them.

**1. Sign in to BrowserStack**

Sign in to your [BrowserStack account](https://www.browserstack.com/users/sign_in) as the Group Admin or Owner you chose.

<ul>
  <li>Navigate to **Account** > **Settings**, or open the [Settings page](https://www.browserstack.com/accounts/settings) directly.</li>
</ul>

**2. Copy the username and access key**

BrowserStack shows your username and access key on the **Settings** page. Copy both and store them securely for use later.

<ul>
  <li>Paste the username into the **Username** field and the access key into the **Access Key** field in StackOne Hub.</li>
</ul>

## Rotate or replace the access key

An access key does not expire by default. If your organization turns on auto-rotation, BrowserStack replaces every user access key after the duration it sets.

<ul>
  <li>The auto-rotation choices are 30, 60, 90, 180 or 365 days. BrowserStack emails the member 14 days before a key rotates, and **Key validity status** under **Settings** > **Product** > **Local Testing** shows the next date.</li>
  <li>Rotating a key invalidates the old one. The connection stops working until you paste the new key into StackOne Hub.</li>
  <li>To rotate the key, sign in as its owner, select the **User Profile** icon in the top-right corner, then **Account & Profile** > **My Profile**. In **Authentication & Security**, select the rotate icon next to **Access Key**, then select **Confirm**. Copy the new key with the copy icon and paste it into the **Access Key** field in StackOne Hub.</li>
</ul>

## 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>**Username**</li>
  <li>**Access Key**</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.


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