- Category: images & design
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? Yes
- Tools: 53
- Triggers: 0
- Slug:
FIGMA - Version: 20261101_00
Frequently Asked Questions
Why can FIGMA_EXTRACT_DESIGN_TOKENS fail when include_variables is enabled?
Why can FIGMA_EXTRACT_DESIGN_TOKENS fail when include_variables is enabled?
include_variables is enabled, the tool calls Figma’s local variables endpoint and the connected account must have the file_variables:read scope. If Figma returns a 403 saying the endpoint requires file_variables:read, reconnect with Figma credentials that can grant that scope. Figma exposes this scope only for Enterprise organization members.If you do not need Figma variables, set include_variables to false. The tool can still extract tokens from local styles and nodes without calling the variables endpoint.What can cause Figma 429s?
What can cause Figma 429s?
Tools
Add a comment to a file
Add a comment to a file
FIGMA_ADD_A_COMMENT_TO_A_FILEPosts a new comment to a Figma file or branch, optionally replying to an existing root comment (replies cannot be nested); region_height and region_width in client_meta must be positive if defining a comment region.Input Parameters
Output
Add a reaction to a comment
Add a reaction to a comment
FIGMA_ADD_A_REACTION_TO_A_COMMENTPosts a specified emoji reaction to an existing comment in a Figma file or branch, requiring valid file_key and comment_id.Input Parameters
:heart:, :+1::skin-tone-2:). For a comprehensive list of accepted emoji shortcodes, including aliases and skin tone modifiers, refer to the file linked here: https://raw.githubusercontent.com/missive/emoji-mart/main/packages/emoji-mart-data/sets/14/native.json.GET /v1/files/:key endpoint with the branch_data=true query parameter to obtain the branch key if needed.Output
Create a webhook
Create a webhook
FIGMA_CREATE_A_WEBHOOKCreates a Figma webhook for team, project, or file events, sending POST notifications to the configured endpoint. Team webhooks require team admin permissions; project and file webhooks require edit access.Input Parameters
ACTIVE (default): webhook is operational and receives an initial PING event upon creation. PAUSED: webhook is inactive and receives no events; use FIGMA_UPDATE_A_WEBHOOK to activate later.context_id. team: monitors all files in a team (requires team admin). project: monitors all files in a project (requires edit access). file: monitors a specific file (requires edit access). If not provided, team_id must be specified instead.context='team' with context_id instead. Identifier of the Figma team for which this webhook monitors events. To find your team_id: navigate to your team page in Figma (https://www.figma.com/files/team/YOUR_TEAM_ID/Team-Name), the team_id is the number after ‘/team/’ in the URL. Note: team_ids cannot be discovered programmatically via the API.context is specified.Output
Create dev resources
Create dev resources
Create, modify, or delete variables
Create, modify, or delete variables
FIGMA_CREATE_MODIFY_DELETE_VARIABLESManages variables, collections, modes, and their values in a Figma file via batch create/update/delete operations; use temporary IDs to link new related items in one request and ensure variableModeValues match the target variable’s resolvedType.Input Parameters
GET /v1/files/:key with the branch_data=true query parameter to obtain a branch key.Output
Delete a comment
Delete a comment
FIGMA_DELETE_A_COMMENTDeletes a specific comment from a Figma file or branch, provided the authenticated user is the original author of the comment.Input Parameters
GET /v1/files/:key endpoint with the branch_data query parameter.GET /v1/files/:file_key/comments or from the response when creating a comment with POST /v1/files/:file_key/comments. Only the author of the comment can delete it.Output
Delete a reaction
Delete a reaction
FIGMA_DELETE_A_REACTIONDeletes a specific emoji reaction from a comment in a Figma file; the user must have originally created the reaction.Input Parameters
GET /v1/files/:key endpoint with the branch_data query parameter.Output
Delete a webhook
Delete a webhook
Delete dev resource
Delete dev resource
FIGMA_DELETE_DEV_RESOURCEDeletes a development resource (used to link Figma design elements to external developer information like code or tasks) from a specified Figma file.Input Parameters
Output
Design tokens to tailwind
Design tokens to tailwind
FIGMA_DESIGN_TOKENS_TO_TAILWINDConverts design tokens into Tailwind CSS configuration content with theme extensions, and optionally generates global CSS with font imports.Input Parameters
Output
Detect Background Layers
Detect Background Layers
FIGMA_DETECT_BACKGROUNDDetect background layers for selected nodes in a Figma file. This action analyzes the Figma document structure and identifies potential background elements for the given target nodes. It uses: - Geometric analysis (bounding box overlap/containment) - Z-index ordering (nodes earlier in the layer stack are behind later ones) - Visual properties (fills, node types) - Naming conventions (nodes named ‘background’, ‘bg’, etc.) Returns background candidates with confidence scores (0-1) and explanations.Input Parameters
Output
Discover Figma Resources
Discover Figma Resources
FIGMA_DISCOVER_FIGMA_RESOURCESDiscovers Figma identifiers from supported file, design, board, prototype, slides, team and project URLs, and can list team projects, project files or file nodes. Project and file listing failures may appear as empty results.Input Parameters
Output
Download Figma Images
Download Figma Images
FIGMA_DOWNLOAD_FIGMA_IMAGESDownload images from Figma file nodes. Renders specified nodes as images and downloads them. Supports PNG, SVG, JPG, and PDF formats. REQUIRED PARAMETERS: - file_key (string): The Figma file key from the URL - images (array): List of objects, each containing: - node_id (string, required): The node ID to export (e.g., “1:2”) - file_name (string, required): Output filename with extension (e.g., “logo.png”) - format (string, optional): One of ‘png’, ‘svg’, ‘jpg’, ‘pdf’. Defaults to ‘png’ Example usage: { “file_key”: “abc123XYZ”, “images”: [ {“node_id”: “1:2”, “file_name”: “logo.png”, “format”: “png”} ] } To find node IDs, use FIGMA_GET_FILE_JSON or look in Figma URLs after ‘node-id=’. NOTE: Returned image URLs expire shortly after generation — download them immediately.Input Parameters
Output
Extract design tokens
Extract design tokens
FIGMA_EXTRACT_DESIGN_TOKENSExtracts design tokens from a Figma file using styles, optional variables and node properties. Results may be incomplete or use fallback style values; variables require appropriate access and a supported plan.Input Parameters
Output
Extract Prototype Interactions
Extract Prototype Interactions
FIGMA_EXTRACT_PROTOTYPE_INTERACTIONSExtract prototype interactions and animations from Figma files. Required parameter: - file_key: The Figma file key extracted from a URL like ‘https://www.figma.com/file/ABC123xyz/MyFile’ (the ‘ABC123xyz’ part) Analyzes the prototype data to extract: - User interactions (clicks, hovers, etc.) - Transition animations - Component variant states - User flows and navigationInput Parameters
Output
Get activity logs
Get activity logs
FIGMA_GET_ACTIVITY_LOGSRetrieves Figma organization activity log events with event-type and time-range filters, ordering, and a page-size limit. Access requires an OAuth app and an Enterprise organization admin with the activity log scope.Input Parameters
Output
Get a webhook
Get a webhook
Get comments in a file
Get comments in a file
FIGMA_GET_COMMENTS_IN_A_FILERetrieves all comments from an existing Figma file, identified by a valid file_key, returning details like content, author, position, and reactions, with an option for Markdown formatted content.Input Parameters
GET /v1/files/:key endpoint with the branch_data query parameter.Output
Get component (Deprecated)
Get component (Deprecated)
FIGMA_GET_COMPONENTDEPRECATED: Use FIGMA_GET_FILE_NODES instead. Get component data with automatic simplification. Returns clean, AI-friendly component structure.Input Parameters
Output
Get component
Get component
Get component set
Get component set
Get current user
Get current user
Get dev resources
Get dev resources
FIGMA_GET_DEV_RESOURCESRetrieves development resources (e.g., Jira/GitHub links) for a Figma main file, optionally filtering by specific node IDs.Input Parameters
Output
Get file components
Get file components
FIGMA_GET_FILE_COMPONENTSRetrieves published components from a Figma file, which must be a main file (not a branch) acting as a library.Input Parameters
Output
Get file component sets
Get file component sets
FIGMA_GET_FILE_COMPONENT_SETSRetrieves all published component sets from the specified Figma main file (file_key must not be for a branch).Input Parameters
Output
Get file json
Get file json
FIGMA_GET_FILE_JSONRetrieves data for a Figma Design file or selected nodes, with options to specify a version and limit tree depth. By default it returns a simplified view that omits invisible nodes and empty values; choose full detail for the raw Figma response. Use node IDs and depth to reduce response size for large files.Input Parameters
ids and set depth to the minimum needed.Output
Get file metadata
Get file metadata
FIGMA_GET_FILE_METADATAGet Figma file metadata including name, creator, last modification details, thumbnail, and access information. Use when you need quick file overview without the full document tree.Input Parameters
GET /v1/files/:key with the branch_data query param to get the branch key.Output
Get file nodes
Get file nodes
FIGMA_GET_FILE_NODESFetch JSON for specific node IDs from a Figma file to avoid full-file payload limits. Use when you already know target node IDs (from shallow file fetch or component listings) or when full-file JSON has hit payload limits. Prefer depth=1 for fast discovery.Input Parameters
Output
Get files in a project
Get files in a project
Get file styles
Get file styles
FIGMA_GET_FILE_STYLESRetrieves a list of published styles (like colors, text attributes, effects, and layout grids) from a specified main Figma file (not a branch).Input Parameters
Output
Get image fills
Get image fills
FIGMA_GET_IMAGE_FILLSRetrieves temporary (14-day expiry) download URLs for all image fills in a Figma file; requires imageRef from Paint objects to map URLs.Input Parameters
Output
Get library analytics component action data
Get library analytics component action data
FIGMA_GET_LIBRARY_ANALYTICS_COMPONENT_ACTION_DATARetrieves component insertion and detachment analytics for a specified Figma library, groupable by ‘component’ or ‘team’ and filterable by a date range (YYYY-MM-DD).Input Parameters
cursor field; omit for the first page.Output
Get library analytics component usage data
Get library analytics component usage data
FIGMA_GET_LIBRARY_ANALYTICS_COMPONENT_USAGE_DATARetrieves component usage analytics for a specified Figma library file (identified by file_key), with data groupable by ‘component’ or ‘file’.Input Parameters
rows structure. Use ‘component’ to see per-component usage stats, or ‘file’ to see which files use the library.Output
Get library analytics style action data
Get library analytics style action data
FIGMA_GET_LIBRARY_ANALYTICS_STYLE_ACTION_DATARetrieves style usage analytics (insertions, detachments) for a Figma library, grouped by ‘style’ or ‘team’; if providing a date range, ensure end_date is not before start_date.Input Parameters
cursor field to fetch the next page; omit for first page.Output
Get library analytics style usage data
Get library analytics style usage data
FIGMA_GET_LIBRARY_ANALYTICS_STYLE_USAGE_DATARetrieves style usage analytics for a published Figma library. Returns data about how styles (colors, text styles, effects, grids) from the library are being used across your organization. Requires Enterprise plan and library_analytics:read scope. Group results by ‘style’ to see per-style metrics or by ‘file’ to see which files use the library’s styles.Input Parameters
Output
Get library analytics variable action data
Get library analytics variable action data
FIGMA_GET_LIBRARY_ANALYTICS_VARIABLE_ACTION_DATARetrieves weekly, paginated analytics data on variable insertions and detachments for a specified Figma library (identified by file_key), groupable by ‘variable’ or ‘team’, and filterable by an optional date range. Note: Requires Enterprise plan and library_analytics:read scope.Input Parameters
rows in the response.Output
Get library analytics variable usage data
Get library analytics variable usage data
FIGMA_GET_LIBRARY_ANALYTICS_VARIABLE_USAGE_DATARetrieves paginated analytics data on variable usage from a specified Figma library, grouped by ‘file’ or ‘variable’, for libraries with enabled analytics.Input Parameters
cursor field if next_page was true. Omit for the first page.rows in the response (‘file’ or ‘variable’).Output
Get local variables
Get local variables
FIGMA_GET_LOCAL_VARIABLESRetrieves all local/remote variables for a Figma file/branch; crucial for obtaining mode-specific values which /v1/files/{file_key}/variables/published omits.Input Parameters
GET /v1/files/:key with the branch_data query parameter).Output
Get payments
Get payments
FIGMA_GET_PAYMENTSRetrieves a user’s payment information for a Figma plugin, widget, or Community file; the authenticated identity must own the resource.Input Parameters
plugin_payment_token is not provided.user_id is provided, specify exactly one of community_file_id, plugin_id, or widget_id.user_id is provided, specify exactly one of community_file_id, plugin_id, or widget_id.user_id is provided, specify exactly one of community_file_id, plugin_id, or widget_id.getPluginPaymentTokenAsync (Figma Plugin Payments API). See Figma docs ‘Calling the Payments REST API…’. If provided, user_id and resource IDs are typically not needed.Output
Get projects in a team
Get projects in a team
FIGMA_GET_PROJECTS_IN_A_TEAMRetrieves projects (folders) visible to the authenticated user in a specified Figma team. On plans with nested folders enabled, results include only top-level folders.Input Parameters
team_id cannot be programmatically obtained solely from a user token. To find a team_id, navigate to a team page you are a member of in Figma. The team_id will be present in the URL, typically formatted as https://www.figma.com/files/team/YOUR_TEAM_ID/Your_Team_Name.Output
Get published variables
Get published variables
FIGMA_GET_PUBLISHED_VARIABLESRetrieves variables published from a specified Figma file; this API is available only to full members of Enterprise organizations.Input Parameters
Output
Get reactions for a comment
Get reactions for a comment
Get SCIM service provider config
Get SCIM service provider config
Get style
Get style
FIGMA_GET_STYLERetrieves detailed metadata for a specific style in Figma using its unique style key.Input Parameters
Output
Get team components
Get team components
FIGMA_GET_TEAM_COMPONENTSRetrieves components published in a specific Figma team’s library; the team must have published components, otherwise an empty list is returned.Input Parameters
before parameter. The cursor value is an internally tracked integer that doesn’t correspond to any specific Figma IDs.after parameter. The cursor value is an internally tracked integer that doesn’t correspond to any specific Figma IDs.Output
Get team component sets
Get team component sets
FIGMA_GET_TEAM_COMPONENT_SETSRetrieves a paginated list of published component sets (collections of reusable UI elements) from a specified Figma team’s library.Input Parameters
Output
Get team styles
Get team styles
FIGMA_GET_TEAM_STYLESRetrieves a paginated list of published styles (fill colors, text styles, effects, grids) from a specified Figma team’s library. Note: The team must have published styles in its library for this endpoint to return data. Teams without published styles will return an empty list.Input Parameters
cursor.after from a previous response. Mutually exclusive with before - only one can be specified.cursor.before from a previous response. Mutually exclusive with after - only one can be specified.Output
Get webhooks
Get webhooks
FIGMA_GET_TEAM_WEBHOOKSRetrieves webhooks registered for a specified Figma team, project, or file context using the Webhooks V2 API.Input Parameters
Output
Get versions of a file
Get versions of a file
FIGMA_GET_VERSIONS_OF_A_FILERetrieves the version history for a Figma file or branch, as specified by its file_key.Input Parameters
GET /v1/files/:key with the branch_data query param to obtain it. The authenticated user must have access to the file; otherwise a 404 ‘Not found’ error is returned.Output
Get webhook requests
Get webhook requests
FIGMA_GET_WEBHOOK_REQUESTSRetrieves a history of webhook requests for a specific Figma webhook subscription; data is available for requests sent within the last seven days.Input Parameters
Output
Render images of file nodes
Render images of file nodes
FIGMA_RENDER_IMAGES_OF_FILE_NODESRender Figma nodes as images (PNG, JPG, SVG, PDF). Returns a map of node IDs to temporary image URLs (valid for 30 days). Images are capped at 32 megapixels; larger requests are automatically scaled down. REQUIRED PARAMETERS: - file_key: Figma file key from URL (e.g., ‘abc123XYZ’ from figma.com/design/abc123XYZ/…) - ids: Comma-separated node IDs to render (e.g., ‘1:2’ or ‘1:2,1:3,1:4’) NODE IDs: Found in Figma URLs after ‘node-id=’ or from FIGMA_GET_FILE_JSON response. FORMATS: - png/jpg: Raster images with optional scale (0.01-4.0) - svg: Vector graphics with text outline options - pdf: Document format COMMON ISSUES: - null value in images map = node failed to render (invalid ID, invisible, 0% opacity) - 404 error = file_key not found or no access - 429 error = rate limit exceeded, wait and retryInput Parameters
Output
Update a webhook
Update a webhook
FIGMA_UPDATE_A_WEBHOOKUpdates an existing Figma webhook, identified by webhook_id, allowing modification of its event type, endpoint, passcode, status, or description.Input Parameters
ACTIVE to receive events, PAUSED to temporarily stop event delivery. Optional - only provide to change status.