---
title: How do I use a Vercel API Access Token?
description: An Access Token is required in order to use the Vercel API. Tokens can be created and managed at the level of your account.
url: /kb/guide/how-do-i-use-a-vercel-api-access-token
canonical_url: "https://vercel.com/kb/guide/how-do-i-use-a-vercel-api-access-token"
published: 2025-11-03
last_updated: 2025-11-10
authors: Ismael Rumzan
related:
  - /docs/rest-api
  - /docs/api
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [CLI Reference](https://vercel.com/docs/sandbox/cli-reference?from=related) — Based on the Docker CLI, you can use the Sandbox CLI to manage your Vercel Sandbox from the command line.
- [Access tokens](https://vercel.com/docs/accounts/access-tokens?from=related) — Create and scope Vercel access tokens to your full account, a team, or a single project, then use them to authenticate A
- [Create an Auth Token](https://vercel.com/docs/rest-api/authentication/create-an-auth-token?from=related)
- [Tokens](https://vercel.com/docs/sign-in-with-vercel/tokens?from=related) — Learn how to Sign in with Vercel
- [List Auth Tokens](https://vercel.com/docs/rest-api/authentication/list-auth-tokens?from=related)
- [How do I add a domain using the Vercel API?](https://vercel.com/kb/guide/how-do-i-add-a-domain-using-the-vercel-api?from=related) — Information on adding a domain using the Vercel API.

Full cross-link map for this page: [/kb/guide/how-do-i-use-a-vercel-api-access-token.graph.md](/kb/guide/how-do-i-use-a-vercel-api-access-token.graph.md)
<!-- /docsgraph:related -->


[Vercel Access Tokens](https://vercel.com/docs/rest-api#introduction/api-basics/authentication) are required to authenticate and use the [Vercel API](https://vercel.com/docs/api).

Tokens can be created and managed inside your account settings, and can be scoped to only allow access for specific Teams. This article covers how to create a token and use it with your account.

## Creating an Access Token

Make sure that you are under **Personal Account** and not **Teams** in the dropdown at the top left in the Navigation bar. Navigate to the [Account Tokens page](https://vercel.com/account/tokens), also found under the **Settings** area of your Personal Account.

1. Click **Create** to open the create token modal.
   
2. Enter a descriptive name and click **Create Token**.
   
3. Choose the scope of access for the token from the dropdown.
   
4. Make a note of the token created as it will **not be shown again**.
   

## Using the Access Token in Personal Account API Calls

Once your [token has been created](https://vercel.com/guides/how-do-i-use-a-vercel-api-access-token#how-to-create-the-token), you can use it with the Vercel API. For example:

1. Identify the [Vercel API endpoint](https://vercel.com/docs/api) you would like to call. For example, to list the deployments in your Personal Account, the endpoint is `/v6/deployments`. The access token token you created would need access to your Personal Account.
   
2. Make a request to `https://api.vercel.com/v6/deployments` using your access token as the Authorization header.
   

```bash
curl"https://api.vercel.com/v6/deployments" -H "Authorization: Bearer TOKEN"
```
```javascript
const result = await fetch(
    'https://api.vercel.com/v6/deployments',
    {
        method: 'GET',
        headers: {
            Authorization: `Bearer ${process.env.VERCEL_ACCESS_TOKEN}`,
        }
    }
);
```

## Using the Access Token in Team API Calls

If you are trying to retrieve deployments for a team, you will need to append `?teamId=<your-team-id>` to the URL. Your Team ID can be found inside your team's general project settings on the dashboard.

You will also need to ensure the access token created has the correct scope for the Team.

```javascript
const teamId = 'replace-me'
const result = await fetch(
    `https://api.vercel.com/v6/deployments?teamId=${teamId}`,
    {
        method: 'GET',
        headers: {
            Authorization: `Bearer ${process.env.VERCEL_ACCESS_TOKEN}`,
        }
    }
);
```