DocumentationAdobe Workfront Fusion

Frame.io modules

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

The Adobe Workfront Fusion Frame.io modules enable you to monitor, create, update, retrieve, or delete assets and comments in your Frame.io account.

For a video introduction to the Frame.io connector, see:

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 Frame.io modules, you must have a Frame.io account

Frame.io API information

The Frame.io connector uses the following:

Base URL
https://api.frame.io/v2
API version
v2
API tag
v1.0.76

Connect Frame.io to Adobe Workfront Fusion

You can connect to Frame.io using an API token, or by using OAuth 2.0.

Connect to Frame.io using an API token

Connect to Frame.io using OAuth 2.0 PKCE

Connect to Frame.io using an API token

To connect your Frame.io account to Workfront Fusion using an API token, you must create the API token in your Frame.io account and insert it to the Workfront Fusion Frame.io Create a connection dialog.

  1. Log in to your Frame.io account.
  2. Go to the Tokens page in the Frame.io Developer.
  3. Click New.
  4. Enter the name of the token, select the scopes you want to use, and click Create.
  5. Copy the provided token.
  6. Go to Workfront Fusion and open the Frame.io module’s Create a connection dialog.
  7. In the Connection type field, select Frame.io.
  8. Enter the token you have copied in step 5 to the Your Frame.io API Key field
  9. Click Continue to establish the connection and return to the module.

Connect to Frame.io using OAuth 2.0 PKCE

You can create an connection to Frame.io using OAuth 2.0 PKCE with an optional Client ID. If you want to include a Client ID in your connection, you must create an OAuth 2.0 app in your Frame.io account.

Connect to Frame.io using using OAuth 2.0 PKCE (without Client ID)

  1. Go to Workfront Fusion and open the Frame.io module’s Create a connection dialog.
  2. In the Connection type field, select Frame.io OAuth 2.0 PKCE.
  3. Enter a name for the new connection in the Connection name field.
  4. Click Continue to establish the connection and return to the module.

Connect to Frame.io using using OAuth 2.0 PKCE (with Client ID)

  1. Create an OAuth 2.0 app in Frame.io. For instructions, see the Frame.io documentation on OAuth 2.0 Code Authorization Flow.

    note important
    IMPORTANT
    When creating the OAuth 2.0 app in Frame.io:

    • Enter the following as the redirect URI:

      • Americas / APAC: https://app.workfrontfusion.com/oauth/cb/frame-io5

      • EMEA: https://app-eu.workfrontfusion.com/oauth/cb/frame-io5

    • Enable the PCKE option.

  2. Copy the provided client_id.

  3. Go to Workfront Fusion and open the Frame.io module’s Create a connection dialog.

  4. In the Connection type field, select Frame.io OAuth 2.0 PKCE.

  5. Enter a name for the new connection in the Connection name field.

  6. Click Show advanced settings.

  7. Enter the client_id you copied in step 2 to the Client ID field.

  8. Click Continue to establish the connection and return to the module.

Frame.io modules and their fields

When you configure Frame.io modules, Workfront Fusion displays the fields listed below. Along with these, additional Frame.io 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

Assets

Create an Asset

This action module creates a new asset.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that you want to create an asset for.
Project ID
Select the project or map the ID of the project that you want to create an asset for.
Folder ID
Select the folder or map the ID of the folder you want to create an asset in.
Type
Select whether to create a folder or file.
Name
Enter the name of the new file or folder.
Source URL
If creating a file, enter the URL of the file you want to upload.
Description
If creating a file, enter a brief description of the asset.
Label
If creating a file, select whether the file is in progress, needs review, or is approved.

Delete an Asset

This action module deletes a specified asset.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the asset you want to delete.
Project ID
Select the project or that contains the asset you want to delete.
Folder ID
Select the folder that contains the asset you want to delete
Asset ID
Select or map the asset you want to delete.

Get an Asset

This action module retrieves asset details.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the asset you want to retrieve details about.
Project ID
Select the project that contains the asset you want to retrieve details about.
Folder ID
Select the folder that contains the asset you want to retrieve details about.
Asset ID
Select the asset or map the ID of the asset you want to retrieve details about.

List Assets

This search module retrieves all assets in the specified project’s folder.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the folder you want to retrieve assets from.
Project ID
Select the project that contains the folder you want to retrieve assets from.
Folder ID
Select the folder you want to list assets from.
Limit
Enter or map the maximum number of assets you want the module to return during each scenario execution cycle.

Update an Asset

This action module allows you to update an existing asset’s name, description, or custom fields.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that you want to update an asset for.
Project ID
Select the project or map the ID of the project that you want to update an asset for.
Folder ID
Select the folder or map the ID of the folder you want to update an asset in.
Asset ID
Enter or map the ID of the asset that you want to update.
Name
Enter the name of the updated file.
Description
Enter a brief description of the updated asset.

Watch Asset Deleted

This trigger module starts a scenario when an asset belinging to the specified team is deleted.

Because this is an instant trigger, you must select or create a webhook for the module to use.

If adding a webhook, enter the following information.

Webhook name
Enter a name for the webhook, such as "Asset deleted."
Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select the team this webhook is created for.

Watch Asset Label Updated

This trigger module starts a scenario when an the label for an asset owned by the specified team set, changed, or removed.

Because this is an instant trigger, you must select or create a webhook for the module to use.

If adding a webhook, enter the following information.

Webhook name
Enter a name for the webhook, such as "Asset status updated."
Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select the team this webhook is created for.

Watch New Asset

This trigger module starts a scenario when a new asset is created for the specified team.

Because this is an instant trigger, you must select or create a webhook for the module to use.

If adding a webhook, enter the following information.

Webhook name
Enter a name for the webhook, such as "Asset created."
Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select the team this webhook is created for.

Comments

Create a Comment

This action module adds a new comment or reply to the asset.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Type
Select whether you want to create a comment or reply to a comment.
Team ID
Select or map the team that owns the project that contains the asset you want to add a comment to.
Project ID
Select the project or map the ID of the project that contains the asset you want to add a comment to.
Folder ID
Select the folder or map the ID of the folder that contains the asset you want to add a comment to.
Asset ID
Select or map the asset you want to add a comment to.
Comment ID
Select or map the comment you want to add a reply to.
Text
Enter the text content of the comment or reply.
Timestamp
Enter the frame number in the video the comment should be linked to.

Delete a Comment

This action module deletes an existing comment.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the asset you want to delete a comment from.
Project ID
Select the project or map the ID of the project that contains the asset you want to delete a comment from.
Folder ID
Select the folder that contains the asset you want to delete a comment from.
Asset ID
Enter or map the ID of asset that contains the comment you want to delete.
Comment ID
Enter or map the ID of the comment you want to delete.

Get a Comment

This action module retrieves details of the specified comment.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the folder you want to retrieve assets from..
Project ID
Select the project that contains the folder you want to retrieve assets from.
Folder ID
Select the folder you want to list assets from.
Asset ID
Select the asset that contains the comment you want to retrieve.
Comment ID
Select the comment you want to retrieve details about.

List Comments

This search module retrieves all comments of the specified asset.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the folder you want to retrieve comments from.
Project ID
Select the project that contains the folder you want to retrieve comments from.
Folder ID
Select the folder that contains the asset you want to list comments from.
Asset ID
Select the asset you want to list comments for.
Limit
Enter or map the maximum number of comments you want the module to return during each scenario execution cycle.

Update a Comment

This action module edits an existing comment.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team that owns the project that contains the asset you want to update a comment on.
Project ID
Select the project \ that contains the asset you want to update a comment on.
Folder ID
Select the folder that contains the asset you want to update a comment on.
Asset ID
Select the asset you want to update a comment on.
Comment ID
Select the comment you want to update.
Text
Enter the text content of the comment.
Timestamp
Enter the frame number in the video the comment is linked to.

Watch Comment Updated

This trigger module starts a scenario when a comment is edited.

Because this is an instant trigger, you must select or create a webhook for the module to use.

If adding a webhook, enter the following information.

Webhook name
Enter the name of the webhook, e.g. Comment Edited.
Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select the team this webhook is created for.

Watch New Comment

This trigger module starts a scenario when a new comment or reply is created.

Because this is an instant trigger, you must select or create a webhook for the module to use.

If adding a webhook, enter the following information.

Webhook name
Enter the name of the webhook, e.g. New Comment.
Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select the team this webhook is created for.

Projects

List Projects

This search module retrieves all projects for the specified team.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team ID
Select or map the team you want to retrieve projects for.
Limit
Enter or map the maximum number of projects you want the module to return during each scenario execution cycle.

Other

Make an API Call

This module allows you to perform a custom API call.

Connection
For instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
URL

Enter a path relative to https://api.frame.io. Example: /v2/teams

Note: For the list of available endpoints, refer to the Frame.io API Reference.

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 authorization headers automatically.

Query String
Enter the request query string. For each parameter that you want to include in the query string, click Add item and enter the field's name and the desired value.
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.

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