Knowledge
Figma
Embed Figma file thumbnails into Atlas tasks and watch file change activity so product reviews stay in sync.
What this connector does
- Embed Figma file thumbnails inline on Atlas tasks.
- Read file and project metadata for evidence rows.
- Listen for file update events using Figma webhooks v2.
- Never store full design file content.
Before you begin
- You are a Figma team admin.
- Your plan allows the Webhooks v2 API (Professional or higher).
- You have a sandbox team to validate the first connection.
Get your credentials
Open the Figma developer settings
Sign in with the admin account. figma.com/developers/apps
Create a new OAuth app
Name it Atlas Connector and add the website URL.
Add the Atlas redirect URL
Set Callback URL to https://YOUR-ATLAS-HOST/oauth/callback/figma.
Select scopes
Pick file_read for file metadata access. Webhooks v2 do not require an additional scope.
Copy the client id and secret
Copy Client ID and Client Secret into the Atlas Figma connector settings page.
Required scopes and permissions
file_readcurrent_user:readSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
invalid_token
Refresh token expired. Reconnect from Atlas.
No files visible
The connected user must be a member of the team that owns the files.
webhook 403
The team plan does not include webhooks. Upgrade or use polling mode.
Webhooks
Atlas creates webhooks v2 per team and validates the signature header.
Events Atlas listens for
- FILE_UPDATE
- FILE_VERSION_UPDATE
- FILE_COMMENT
- LIBRARY_PUBLISH
Provider docs: https://www.figma.com/developers/api#webhooks-v2
Disconnect and data deletion
- Click Disconnect on the Atlas Figma connector page.
- Open developer apps and delete the Atlas Connector app.
- Atlas removes cached file metadata within 24 hours of disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Figma.
Open the Figma connector page