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:readscope, so Get Team Projects and Get Project Files fail with this method. To use them, set up OAuth with your own Figma app and addprojects: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
-
Click + Create a new app
-
Give your app a name and click Create App
-
Copy the Client ID and Client Secret
-
In Willow, paste the Client ID and Client Secret
-
Click Done in Figma
-
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
- For SaaS deployments:
-
In Figma, go to the OAuth Credentials tab
-
Click Add redirect URL and paste the URL from above
-
Go to the OAuth Scopes tab and select the scopes you want
-
In Willow, add the exact same scopes you selected in Figma
-
In Willow, click Save Changes
Generating an API Key
-
Go to figma.com
-
In the top left, click on your name
-
Go to Settings
-
Navigate to the Security tab
-
Under Personal access tokens, click Generate new token
-
Choose the scopes for the token
-
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.