> ## 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 Vercel with Access Token – StackOne Hub

> Link a Vercel account in the StackOne Hub using Access Token. End-user guide to authorize the integration and start using Vercel actions.

> [!WARNING]
>
> Create the token from the account of a team Owner. Vercel has no read-only token. A team token can read and change all of the team's resources, across every project, with the permissions of the person who creates it, and StackOne's write actions use it to invite, update and remove members. Vercel documents only Owners as able to invite people, change roles and remove members. It documents that a Contributor cannot list team members, and it does not say which other roles can list members and Access Groups. Team roles need a Pro or Enterprise plan. Access Groups need an Enterprise plan; on other plans the unified groups list is empty and the Access Group actions fail. If the team requires two-factor authentication or SAML, set that up before creating the token.

## Create the access token

A Vercel access token belongs to your personal account and reaches only the team or project you scope it to.

**1. Sign in to Vercel**

Sign in to your [Vercel account](https://vercel.com/login) as a team Owner.

<ul>
  <li>In the team switcher at the top left of the navigation bar, make sure you are viewing your personal account and not a team.</li>
  <li>Open the [Account Tokens page](https://vercel.com/account/settings/tokens), found under the Settings area of your account.</li>
</ul>

**2. Name the token**

Enter a descriptive token name.

<ul>
  <li>Token name: `StackOne Integration`</li>
</ul>

**3. Choose the team**

Open **Scope** and select the team StackOne should read.

<ul>
  <li>If Vercel then shows a project list, select **All Projects**. A token for one project cannot reach team resources.</li>
  <li>Do not select **Full Account**. It reaches your personal account and every team you belong to.</li>
</ul>

**4. Choose an expiration and create**

Choose an expiration, then select **Create**.

<ul>
  <li>Vercel offers expiration dates from 1 day to 1 year. Pick one that covers how long the connection should run.</li>
  <li>Once the expiration date passes, the token stops working and the connection fails until you paste a new token into StackOne Hub.</li>
</ul>

**5. Copy the token**

Copy the token and store it securely for use later.

<ul>
  <li>The token is shown once, and you cannot retrieve it later.</li>
  <li>Paste it into the **Access Token** field in StackOne Hub.</li>
</ul>

## Find your Team ID

The **Team ID** is the unchangeable identifier Vercel assigns when a team is created. It is optional. Leave it empty and StackOne uses the team the token is scoped to. If StackOne finds no team, or several, the connection stops with a message asking for the Team ID.

**1. Open the team settings**

Select your team in the team switcher, open **Settings** in the sidebar and choose **General**.

<ul>
  <li>Or open `https://vercel.com/teams/{team slug}/settings#team-id`, replacing `{team slug}` with the part of the address after `vercel.com/` when you view your team.</li>
</ul>

**2. Copy the Team ID**

Scroll down to the **Team ID** section and copy the value.

<ul>
  <li>Format: starts with `team_`</li>
  <li>Example: `team_AbCd1234`</li>
  <li>Paste it into the **Team ID** field in StackOne Hub.</li>
</ul>

## Revoke the token

To stop StackOne from reading your team, delete the token. The connection stops authenticating.

<ul>
  <li>Open the [Account Tokens page](https://vercel.com/account/settings/tokens) from your personal account.</li>
  <li>Delete the token you created for StackOne.</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>**Access Token**</li>
  <li>**Team ID** (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.


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