Skip to main content
Personal Access Tokens grant access to your Figma account. Keep them secure and never share publicly.

Generate a personal access token

Create a new personal access token for API authentication.

1

Sign in to Figma

Sign in to your Figma account.

  • Click your profile avatar in the top-left corner and select Settings.
  • Navigate to the Security tab.
  • Scroll to Personal access tokens.
2

Create new token

Click Generate new token.

  • Enter a descriptive Token name (e.g., “StackOne Integration”)
  • Select an expiration period (max 90 days)
3

Select token scopes

Enables actions: Auth Test, Bulk Create Dev Resources, Bulk Update Dev Resources, Create Comment, Create Comment Reaction, Create Webhook, Delete Comment, Delete Comment Reaction, Delete Dev Resource, Delete Webhook, Get Comment Reactions, Get Comments, Get Component, Get Component Set, Get Current User, Get File, Get File Component Sets, Get File Components, Get File Metadata, Get File Nodes, Get File Styles, Get File Versions, Get Image Fills, Get Project Files, Get Style, Get Team Component Sets, Get Team Components, Get Team Projects, Get Team Styles, Get Unified Credentials, Get Unified Organization, Get Webhook, Get Webhook Requests, Get Webhooks, List Dev Resources, List Unified Organizations, Render Images, Update Webhook

Under Scopes, enable the permissions for your use case.

  • Enterprise-only scopes (file_variables:read, file_variables:write, library_analytics:read) are only visible on the Enterprise plan
4

Generate and copy token

Click Generate token. Copy the token immediately and store securely — it is only shown once.

Find your Team ID

Your Team ID identifies your Figma team workspace. It is required to connect and serves as the default for team-level actions such as listing projects, components, component sets, and styles. Some actions accept their own Team ID input to override this default.

1

Sign in to Figma

Sign in to your Figma account.

  • Click on your team name in the left sidebar.
2

Copy the Team ID from the URL

Look at your browser address bar.

  • Format: https://www.figma.com/files/team/TEAM_ID/team-name
  • Example: if your URL is https://www.figma.com/files/team/1234567890/My-Team, your Team ID is 1234567890

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Personal Access Token
  • Team ID
  • SCIM Tenant ID (Optional)
  • SCIM Bearer Token (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.