Connecting Figma: Setup Guide Thank you for integrating your Figma teams with Windmill! While our integration works seamlessly in most cases, there are a few important details to ensure you get the most out of this connection.
Finding Your Figma Team IDs When connecting Figma to our platform, you'll need to manually provide your Team IDs. Unfortunately, Figma's API doesn't allow for programmatic fetching of these IDs, so this step must be completed manually.
How to Find Your Team ID:
Log into your Figma account
Navigate to the team workspace you want to connect
Look at the URL in your browser - the Team ID appears after the "team/" portion of the URL
Example: In https://www.figma.com/files/team/12345678901234567/Team-Name, the Team ID is 12345678901234567
If you're using Figma's desktop app, you can find it here:
Understanding Figma Access Permissions Our integration can only access what the authenticating user can access. This is a fundamental aspect of how Figma's API works:
User-Based Authentication
The Figma connection is tied to the specific person who authenticated it
Our integration inherits exactly the same permissions as that user
If the authenticating user can't access a project, our integration can't either
How to Ensure Maximum Coverage For the most comprehensive integration, we strongly recommend:
Having a design lead, team admin, or someone with broad access permissions authenticate the connection
Consider setting up multiple Figma installations authenticated by different users if needed to ensure complete coverage
Troubleshooting Access Issues If you're seeing "You don't seem to have permission to do that" errors for some projects:
Check the authenticating user's access:
Verify that the person who connected Figma has permission to view the missing projects
If they don't, either grant them access or have another user with appropriate permissions set up a connection
Project permission settings are also a factor:
Projects with custom permissions (rather than inherited team permissions) may have limited access
Check if projects with access issues have custom permission settings by clicking the "Share" button
Consider updating project permissions to include the authenticating user
Best Practices for Comprehensive Integration
Have a Figma admin or owner set up the initial connection
For design teams with complex permission structures, set up multiple connections with different users
Review your team's project permission inheritance settings periodically
When creating new projects, consider how permission settings will affect integration visibility
Need Additional Help? If you're experiencing issues with your Figma integration or have questions about configuring permissions, please contact our support team at [email protected].