Create a new access token

To use any of Mapbox’s tools, APIs, or SDKs, you’ll need a Mapbox access token. Mapbox uses access tokens to associate requests to API resources with your account. You can find all of your access tokens, create new ones, or delete existing ones on your API Access Tokens page.

Every access token has permissions to make certain types of requests to Mapbox APIs – these are called scopes. When creating an access token, you will have the option to add additional public or private scopes to your token. If you choose to add secret scopes to your token, you will only have the chance to view the actual token itself once.

When choosing scopes, consider what you plan to do with the token. For example, if you are creating a token to upload data to Mapbox with the Mapbox Uploads API, you will want to make sure you select the uploads:write and uploads:read scopes.

To create a new token:

  1. In Mapbox Studio, navigate to your Account page and click the API access tokens tab.
  2. Click Create a new token and give your new token a name to help you remember its purpose.
  3. If you would like to specify scopes, click Add.
  4. Click Create to create the token. You may be prompted to re-enter your password.

Your new token should appear at the top of your list of tokens. You can click on the name of any token to see the scopes it covers, and on public tokens you can also see the token itself.

Additional questions? Ask our support team or learn more about How Mapbox Works.