---
description: >-
  Step-by-step guide on generating and managing your personal access tokens
  required to use the RudderStack API.
---

# Personal Access Tokens

To consume all the public RudderStack APIs, you need an access token associated with your RudderStack account. This guide describes the steps to generate a **personal access token** and the operations associated with it.

## Generating a personal access token

Follow these steps to generate a personal access token:

1. Log into your [RudderStack dashboard](https://app.rudderstack.com/).
2. Go to **Settings** > **Personal access tokens**, as shown:

![Personal access tokens setting in RudderStack dashboard](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-188c28126e3c6944e9cd39021abc851a72dd4fcd%2Fpersonal-access-tokens-1.png?alt=media)

1. Click on **Generate new token**, as shown:

![New personal access token in RudderStack dashboard](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-d8fa86b65799f88c281b70f4e419b7e451cd09b4%2Fnew-personal-access-token.png?alt=media)

1. Enter your **Token name** and select the permissions (**Role**) associated with this token, from the dropdown:

![Personal access token name and role](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-6089910639dd5fc9ff32405acd49bcfac54a1daa%2Fpersonal-access-tokens-2.png?alt=media)

1. Then, click on **Generate**.
2. Copy and save the personal access token details securely.

![Personal access token details](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-12b22f9119563e5213e482af6d4a4fa3307ff080%2Fpersonal-access-tokens-3.png?alt=media)

Make sure you copy the generated token as it will not be visible again once you close this window.

## Deleting a personal access token

To delete an existing token, click on the corresponding **Delete** option next to that token, and confirm by clicking on **Yes, delete**.

To delete all the existing tokens, click on the **Revoke all** button on the top right and click on **Yes, delete**.

## Permissions

The RudderStack Cloud users only with [Read-Write](https://www.rudderstack.com/docs/rudderstack-cloud/teammates/#read-write) or [Admin](https://www.rudderstack.com/docs/rudderstack-cloud/teammates/#admin) access permissions can create their own access tokens and use them.

## Contact us

For queries on any of the sections covered in this guide, you can [contact us](mailto:%20docs@rudderstack.com) or start a conversation in our [Slack](https://rudderstack.com/join-rudderstack-slack-community) community.
