Skip to main content

Figma

Figma is a collaborative interface design tool that enables teams to create, test, and ship designs from start to finish.

Authentication Types​

Figma supports 4 authentication methods:

  • OAuth - Create your own Figma OAuth app, define the scopes (permissions), and have full control. Every user connects with their specific permissions, and you can see who made each call.

    • Pros: Full control, per-user tracking, production-ready
    • Cons: ~2 min setup
  • Instant OAuth - Use Willow's pre-configured Figma app for the fastest setup.

    • Pros: Fastest setup, no configuration needed
    • Cons: Not recommended for production. Willow's app doesn't include the projects:read scope, so Get Team Projects and Get Project Files fail with this method. To use them, set up OAuth with your own Figma app and add projects:read, or use an API key whose token has that scope.
  • API Key - A single API key used for all users.

    • Pros: Easy setup
    • Cons: Less secure, no per-user tracking
  • API Key Per User - Every user generates and uses their own personal access token.

    • Pros: Per-user tracking, good for specific use cases
    • Cons: Requires each user to generate their own token

Setting up OAuth​

  1. Go to https://www.figma.com/developers/apps

  2. Click + Create a new app

  3. Give your app a name and click Create App

  4. Copy the Client ID and Client Secret

  5. In Willow, paste the Client ID and Client Secret

  6. Click Done in Figma

  7. Note the Redirect URL for your deployment:

    • For SaaS deployments: https://{org}.withwillow.ai/{org}/api/auth/callback
    • For On-Premise deployments: {connectUrl}/{org}/api/auth/callback
  8. In Figma, go to the OAuth Credentials tab

  9. Click Add redirect URL and paste the URL from above

  10. Go to the OAuth Scopes tab and select the scopes you want

  11. In Willow, add the exact same scopes you selected in Figma

  12. In Willow, click Save Changes

Generating an API Key​

  1. Go to figma.com

  2. In the top left, click on your name

  3. Go to Settings

  4. Navigate to the Security tab

  5. Under Personal access tokens, click Generate new token

  6. Choose the scopes for the token

  7. Copy the token and paste it into Willow

Variables tools​

Get Local Variables and Get Published Variables read Figma variables (design tokens such as colors per mode, spacing, and radii), and Create/Update Variables writes them. They need the file_variables:read scope, or file_variables:write for Create/Update Variables, and Figma serves its variables API only on Enterprise plans. On any other plan a call fails with a 403 from Figma that names the missing scope, whichever authentication method you use. Willow can't add the scope on Figma's side.