DocumentationAdobe Workfront Fusion

Figma Modules

Last update: Thu Jan 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

With the Adobe Workfront Fusion Figma modules, you can retrieve lists of comments, files, file versions, or projects. You can also post a comment or make a call to the Figma API.

If you need instructions on creating a scenario, see the articles under Create a scenario: article index.

For information about modules, see the articles under Modules: article index.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to use the functionality in this article:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package Any
Adobe Workfront license

New: Standard

Or

Current: Work or higher
Adobe Workfront Fusion license**

Current: No Workfront Fusion license requirement.

Or

Legacy: Workfront Fusion for Work Automation and Integration
Product

New:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase Adobe Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.

Prerequisites

To use Figma modules, you must have a Figma account.

Figma API information

The Figma connector uses the following:

Base URL
https://api.figma.com/v1
API version
v1
API tag
v1.8.25

Create a connection to Figma

To create a connection for your Figma modules:

  1. In any Figma module, click Add next to the Connection box.

  2. Fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection type

    For new connections, select Figma without the Legacy tag.

    Figma changed their authentication requrements in January 2025. The Figma connection type meets the new requirements. The Figma (Legacy) connection type will be removed in the future.
    Connection name Enter a name for this connection.
    Client ID Enter your Figme Client ID.
    Client Secret Enter your Figma Client Secret.
    Custom Scopes Enter any custom scopes required for this connection.
    Custom Connection Verify URL The default endpoint to verify the connection was successfully created is: https://api.figma.com/v1/me If this URL is not supported for the Custom Scope, provide a custom Verify Url.

  3. Click Continue to save the connection and return to the module.

Figma modules and their fields

When you configure Figma modules, Workfront Fusion displays the fields listed below. Along with these, additional Figma fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.

Map toggle

Comments

Delete a comment

This action module deletes a single comment from a file.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
File ID
Enter or map the File ID of the file that you want to add a delete a comment from.
Comment ID
Enter the text of the comment you want to delete.

List comments

This search module lists all of the comments attached to a single file in Figma.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
File ID

Enter or map the File ID of the file that you want to retrieve comments for.

  • If you do not know the ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

  • If you do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with, then select the project, then select the file.

Maximum number of returned comments
Enter or map the maximum number of comments you want the module to return during each scenario execution cycle.

Post a comment

This action module posts a comment to a Figma file.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
File ID

Enter or map the File ID of the file that you want to post a comment to.

  • If you do not know the file's ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

  • If you are attempting to find the file's ID and do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with. Select the project, then select the file.

Comment
Enter the text of the comment.

Projects and files

Get a file or image

This action module retrieves a single file or image from a Figma library

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
Object type

Select the type of object you want to retrieve.

  • File

    The module returns the document referred to by Key as a JSON object. The file key can be parsed from any Figma file URL.

    For fields, see Get a file or image: File.

  • File nodes

    Returns the nodes referenced to by IDs as a JSON object. The nodes are retrieved from the Figma file referenced to by Key.

    For fields, see Get a file or image: File nodes.

  • Image

    The module renders images from a file.

    For fields, see Get a file or image: Image.

  • Image fills

    The module returns download links for all images present in image fills in a document. Image fills are how Figma represents any user-supplied images. When you drag an image into Figma, Figma creates a rectangle with a single fill that represents the image, and the user is able to transform the rectangle (and properties on the fill).

    For fields, see Get a file or image: Image fills.

Get a file or image: File
File key
Select the file that you want to return JSON from.
Version ID
Enter or map the version of the file you want the module to return. For the current module, leave this field blank.
Node IDs

To return only a subset of the document, enter the nodes that you want the module to return. The module returns the listed nodes, their children, and anything between the root node and the listed nodes.

For each node that you want to return, click Add and enter the text of the node.

Depth

Enter or map an integer that represents how deep into the document tree you want to return results for.

Example:

  • To return pages only, enter 1.

  • To return pages and top level objects, enter 2.

To return all nodes, leave this field blank.

Geometry
To return vector data, enter paths.
Plugin data
A comma separated list of plugin IDs and/or the string "shared". Any data present in the document written by those plugins will be included in the result in the pluginData and sharedPluginData properties.
Branch data
Enable this option to return branch metadata for the requested file. If the file is a branch, the main file's key is included in the returned response. If the file has branches, their metadata is included in the returned response. Default: false.
Get a file or image: File nodes
File key
Select the file that you want to return JSON from.
Node IDs

Enter the nodes that you want the module to return and convert

For each node that you want to return, click Add and enter the text of the node.

Version ID
Enter or map the version of the file you want the module to return. For the current module, leave this field blank.
Depth

Enter or map an integer that represents how deep into the document tree you want to return results for.

Example:

  • To return pages only, enter 1.

  • To return pages and top level objects, enter 2.

To return all nodes, leave this field blank.

Geometry
To return vector data, enter paths.
Plugin data
A comma separated list of plugin IDs and/or the string "shared". Any data present in the document written by those plugins will be included in the result in the pluginData and sharedPluginData properties.
Get a file or image: Image
File key
Select the file that you want to return JSON from.
Node IDs

Enter the nodes that you want the module to render.

For each node that you want to render, click Add and enter the text of the node.

Scale
To scale the image, enter or map the scaling factor. This number must be between 0.01 and 4.
Format

Select the format for the image output.

  • JPG

  • PNG

  • SVG

  • PDF

SVG - Include ID
Enable this option to include ID attributes for all SVG elements. Default: false.
SVG - Simplify Stroke
Enable this option to simplify inside/outside strokes and use stroke attribute if possible instead of <mask>. Default: true.
Use absolute bounds
Enable this option to use the full dimensions of the node regardless of whether or not it is cropped or the space around it is empty. Use this to export text nodes without cropping. Default: false.
Version
Enter or map the version of the file you want the module to return. For the current module, leave this field blank.
Get a file or image: Image fills
File key
Select the file that you want to return JSON from.

List file version history

This search module returns the version history of a single file in Figma.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
File ID

Enter or map the File ID of the file that you want retrieve version history for.

  • If you do not know the file's ID, click Find Files and enter or map the ID of the project that the file is associated with, then select the file.

  • If you are attempting to find the file's ID and do not know the project's ID, click Find Projects and enter or map the ID of the team that owns the project the file is associated with. Select the project, then select the file.

Maximum number of returned files
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

List project files

This search module returns a list of all files in the specified project.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
File ID

Enter or map the Project ID the project that you want retrieve files for.

  • If you do not know the projects's ID, click Find Projects and enter or map the ID of the team that the project is are associated with, then select the project.
Maximum number of returned files
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

List projects

This search module returns a list of all projects within the specified team.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
Team ID
Enter or map the Project ID of the project that you want to retrieve files for. The team ID can be found in the URL of the team's page in Figma
Maximum number of returned projects
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Components and styles

Get a style or component

This action module retrieves a single style or component, or a set of styles or components.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
Object> type
Select the type of object that you want to retrieve.
<Object> key
Enter the key (unique identifier) of the object you want to retrieve.
Team ID
If retrieving a team component or team component set, enter or map the ID of the team that the record or records are associated with.
Page Size
If retrieving a team component or team component set, enter or map the number or results to return per page. Default: 30.
After

If retrieving a team component or team component set, enter or map the number of the result after which to start retrieving results. This can be combined with the Page Size field to paginate results.

This value does not correspond to object IDs.

This field cannot be used in combination with the Before field.

Before

If retrieving a team component or team component set, enter or map the number of the result before which to start retrieving results. This can be combined with the Page Size field to paginate results.

This value does not correspond to object IDs.

This field cannot be used in combination with the After field.

Other

Make an API call

This action module lets you make a custom authenticated call to the Figma API without having to think through authentication. This way, you can create a data flow automation that can’t be accomplished by the other Figma modules.

Connection
For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Figma in this article.
URL

Enter a path relative to https://api.figma.com/v1/.

For example: files/7179110/comments

Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds the authorization headers for you.

Query String

Add the query for the API call in the form of a standard JSON object.

For example: {"name":"something-urgent"}

Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Watch events

This trigger module starts a scenario when one of the following events occur for a specific team in your Figma team space:

  • File update

  • File version update

  • File delete

  • Library publish

  • File comment

Webhook

Select the webhook that the module watches.

To add a new webhook:

  1. Click Add next to the Webhook field.

  2. Enter a name for the webhook.

  3. Select the connection you want to use for this webhook. For instructions about connecting your Figma account to Workfront Fusion, see Create a connection to Adobe Workfront Fusion - Basic instructions.

  4. Select the event type that you want the module to watch.

  5. Enter the ID of the team whose events you want the webhook to watch.

  6. Select whether you want the webhook to be active or paused.

  7. Enter a description for the webhook.

  8. Click Save to save the webhook and return to the module.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3