Figma Setup

Create a Figma OAuth app to access design files, comments, and variables through Fp Switchboard.

Prerequisites

• Figma account with admin or editor access
• Access to Figma Developer Apps

Setup Steps

1. Create a Figma App

   Go to Figma Developer Apps and click “Create a new app”.

2. Configure App Settings

   • App name: Fp Switchboard
   • Website URL: https://switchboard.fpdigital.ai

3. Add Redirect URI

   Add the OAuth callback URL:

   https://api.switchboard.fpdigital.ai/oauth/figma/callback

4. Configure Scopes

   Add the required scopes:

   files:read
   file_variables:read
   file_variables:write
   file_comments:write

5. Copy Credentials

   Copy the Client ID and Client Secret from your app settings.

Environment Variables

npx wrangler secret put FIGMA_CLIENT_ID
npx wrangler secret put FIGMA_CLIENT_SECRET

Variable	Description
FIGMA_CLIENT_ID	OAuth Client ID from Figma Developer Apps
FIGMA_CLIENT_SECRET	OAuth Client Secret from Figma Developer Apps

Redirect URI

https://api.switchboard.fpdigital.ai/oauth/figma/callback

Important Notes

Note

Figma OAuth tokens do not expire unless revoked. No refresh flow is needed.

• Figma API rate limit: 720 requests per minute
• File access is scoped to the connected user’s permissions
• Design variables require the file_variables:read/write scopes

Common Issues

• “Invalid scope” error: Ensure you’ve added the exact scope names listed above. Figma scopes use underscores, not dots.
• File not accessible: The connected user must have at least viewer access to the file in Figma.
• Large file timeout: Very large Figma files may take longer to process. Switchboard handles timeouts automatically.

Testing

1. Go to your Switchboard Dashboard and navigate to Figma
2. Click Connect and authorize in Figma
3. Click Test Connection to verify
4. Try: “List my recent Figma files” or “Get comments on [file name]”