Create an OAuth application
Register a new application in the Figma Developer Portal.
Sign in to Figma Developers
Sign in to Figma Developers.
- Click My apps > Create a new app.
- Enter an App name (e.g., “StackOne Integration”).
- Select the associated Team/Organization.
- Click Create App.
Copy client credentials immediately
Upon creation, you will see the Client ID and Client Secret in a modal.
- Copy both values immediately and store them securely.
- The Client Secret is only shown once and cannot be retrieved later.
- If you lose the secret, you must regenerate it.
Add redirect URL
In the left sidebar, click OAuth credentials.
- Under Redirect URLs, click Add a redirect URL.
- Enter:
https://api.stackone.com/connect/oauth2/figma/callback - Click Add.
Select OAuth scopes
In the left sidebar, click OAuth scopes. Enable the scopes required for your use case.
- Enterprise-only scopes (file_variables:read, file_variables:write, library_analytics:read) are only visible on the Enterprise plan
- If you enable only a subset of scopes, you must provide the enabled scopes in the Scopes field during connection setup. Otherwise the connection will fail.
- If all scopes are enabled, the Scopes field can be left empty.
Publish the app (optional)
You can optionally publish your app to share it with others. Before publishing, complete the required configuration.
- On the Publish page, choose Audience (Private or Public). This cannot be changed after publishing.
- Click Next.
- In Describe your app, upload a Logo and add a Description.
- Click Next.
- In Review scopes, confirm the requested scopes.
- Click Publish to complete. Private apps are published instantly without Figma review.
Creating the StackOne Connector Profile
To create the Connector Profile in StackOne for Figma:Navigate to Connector Profiles