Figma

Learn how to use Figma with Composio

Overview

SLUG

FIGMA

Description

A collaborative interface design tool.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to file_read,file_comments:write,file_dev_resources:read,file_dev_resources:write,webhooks:write
full
stringDefaults to https://api.figma.com
bearer_token
string
generic_api_key
stringRequired
full
stringDefaults to https://api.figma.com

Tools

SLUG: FIGMA_GET_CURRENT_USER

Retrieves detailed information for the currently authenticated figma user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_GET_FILES_IN_A_PROJECT

Fetches a list of files in a figma project, optionally including branch metadata.

Action Parameters

branch_data
boolean
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_GET_PROJECTS_IN_A_TEAM

Retrieves projects within a specified figma team that are visible to the authenticated user.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_ADD_A_COMMENT_TO_A_FILE

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

Action Parameters

client_meta
object
comment_id
string
file_key
stringRequired
message
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_ADD_A_REACTION_TO_A_COMMENT

Posts a specified emoji reaction to an existing comment in a figma file or branch, requiring valid file key and comment id.

Action Parameters

comment_id
stringRequired
emoji
stringRequired
file_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_CREATE_A_WEBHOOK

Creates a figma webhook for a `team id` to send post notifications for an `event type` to a publicly accessible https `endpoint`; an initial ping is sent unless `status` is `paused`.

Action Parameters

description
string
endpoint
stringRequired
event_type
stringRequired
passcode
stringRequired
status
string
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_CREATE_DEV_RESOURCES

Creates and attaches multiple uniquely-urled development resources to specified figma nodes, up to 10 per node.

Action Parameters

dev_resources
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_CREATE_MODIFY_DELETE_VARIABLES

Manages 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`.

Action Parameters

file_key
stringRequired
variableCollections
array
variableModeValues
array
variableModes
array
variables
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DELETE_A_COMMENT

Deletes a specific comment from a figma file or branch, provided the authenticated user is the original author of the comment.

Action Parameters

comment_id
stringRequired
file_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DELETE_A_REACTION

Deletes a specific emoji reaction from a comment in a figma file; the user must have originally created the reaction.

Action Parameters

comment_id
stringRequired
emoji
stringRequired
file_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DELETE_A_WEBHOOK

Permanently deletes an existing webhook, identified by its unique `webhook id`; this operation is irreversible.

Action Parameters

webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DELETE_DEV_RESOURCE

Deletes a development resource (used to link figma design elements to external developer information like code or tasks) from a specified figma file.

Action Parameters

dev_resource_id
stringRequired
file_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DETECT_BACKGROUND

Detect background layers for selected nodes. uses geometric analysis, z-index ordering, and visual properties to identify potential background layers.

Action Parameters

file_key
stringRequired
search_depth
integerDefaults to 3
target_node_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DISCOVER_FIGMA_RESOURCES

🔍 smart figma resource discovery - never guess ids again! 🎯 easiest method: just paste any figma url to get all ids: • file urls: https://www.figma.com/file/abc123/design → get file key • design urls: https://www.figma.com/design/abc123/design → get file key • node urls: ...?node-id=123:456 → get file key + node id • team urls: .../team/123456/... → get team id 🔄 step-by-step discovery: 1. team id → projects list (with project ids) 2. project id → files list (with file keys + thumbnails) 3. file key → nodes list (with node ids + hierarchy) 💡 common workflows: • extract from url: discoverfigmaresources(figma url="...") • browse team: discoverfigmaresources(team id="123") • list files: discoverfigmaresources(project id="proj 456") • find nodes: discoverfigmaresources(file key="abc123") ✨ get file key for getfilejson, node ids for detectbackground, etc.

Action Parameters

figma_url
string
file_key
string
max_depth
integerDefaults to 2
project_id
string
team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_DOWNLOAD_FIGMA_IMAGES

Download images from figma file nodes. renders specified nodes as images and downloads them using mercury's filedownloadable infrastructure. supports png, svg, jpg, and pdf formats.

Action Parameters

file_key
stringRequired
images
arrayRequired
scale
numberDefaults to 2
svg_include_id
boolean
svg_outline_text
booleanDefaults to True
svg_simplify_stroke
booleanDefaults to True

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_EXTRACT_DESIGN_TOKENS

Extract design tokens from figma files. combines styles, variables, and extracted values to create a comprehensive design token system.

Action Parameters

extract_from_nodes
booleanDefaults to True
file_key
stringRequired
include_local_styles
booleanDefaults to True
include_variables
booleanDefaults to True

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_EXTRACT_PROTOTYPE_INTERACTIONS

Extract prototype interactions and animations from figma files. analyzes the prototype data to extract: - user interactions (clicks, hovers, etc.) - transition animations - component variant states - user flows and navigation

Action Parameters

analyze_components
booleanDefaults to True
file_key
stringRequired
include_animations
booleanDefaults to True

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_GET_ACTIVITY_LOGS

Retrieves activity log events from figma, allowing filtering by event types, time range, and pagination.

Action Parameters

end_time
integer
events
string
limit
integer
order
stringDefaults to asc
start_time
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_GET_A_WEBHOOK

Retrieves detailed information about a specific webhook by its id, provided the webhook exists and is accessible to the user.

Action Parameters

webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: FIGMA_GET_COMMENTS_IN_A_FILE

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

Action Parameters

as_md
boolean
file_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired