Skip to main content
All CollectionsData Connections
Connecting Figma to Windmill
Connecting Figma to Windmill

A guide on how to correctly connect Figma

Updated this week

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:

  1. Log into your Figma account

  2. Navigate to the team workspace you want to connect

  3. Look at the URL in your browser - the Team ID appears after the "team/" portion of the URL

Project Visibility & Access Permissions

Our integration pulls data from projects within your connected teams. If you're seeing messages like "You don't seem to have permission to do that" for some projects, there are two likely causes:

Possible Permission Issues

  1. Project-Level Permission Settings

    • Projects can inherit team permissions OR have custom permission settings

    • Projects with custom permissions might not be accessible to our integration

    • When a project doesn't inherit team permissions, our API calls may fail

  2. User Authentication Permissions

    • Our integration uses the permissions of the user who connected Figma to our platform

    • If that user doesn't have access to certain projects, our integration won't either

How to Check Permissions:

  1. Go to your Team's page in Figma

  2. Select a project that isn't showing up correctly

  3. Click the "Share" button in the top right

  4. Check both:

    • Whether the project inherits team permissions or has custom settings

    • Whether the user who authenticated our integration has access to this project

Troubleshooting Steps:

If some projects aren't appearing in our integration:

  1. Verify the authenticating user has access to all needed projects

  2. For projects with custom permissions, ensure they include the authenticating user

  3. Consider setting projects to inherit team permissions where possible

  4. For maximum coverage, have a team admin or owner perform the integration

Best Practice:

For the most comprehensive integration, we recommend:

  • Using a team admin account to authenticate the integration

  • Ensuring projects inherit team permissions when possible

  • For projects that must have custom permissions, explicitly include the authenticating user

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].

Did this answer your question?