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 URLhttps://api.frame.io/v2
API versionv2
API tagv1.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.

    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.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that you want to create an asset for.
Project IDSelect the project or map the ID of the project that you want to create an asset for.
Folder IDSelect the folder or map the ID of the folder you want to create an asset in.
TypeSelect whether to create a folder or file.
NameEnter the name of the new file or folder.
Source URLIf creating a file, enter the URL of the file you want to upload.
DescriptionIf creating a file, enter a brief description of the asset.
LabelIf 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.

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

Get an Asset

This action module retrieves asset details.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that contains the asset you want to retrieve details about.
Project IDSelect the project that contains the asset you want to retrieve details about.
Folder IDSelect the folder that contains the asset you want to retrieve details about.
Asset IDSelect 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.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that contains the folder you want to retrieve assets from.
Project IDSelect the project that contains the folder you want to retrieve assets from.
Folder IDSelect the folder you want to list assets from.
LimitEnter 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.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that you want to update an asset for.
Project IDSelect the project or map the ID of the project that you want to update an asset for.
Folder IDSelect the folder or map the ID of the folder you want to update an asset in.
Asset IDEnter or map the ID of the asset that you want to update.
NameEnter the name of the updated file.
DescriptionEnter 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 nameEnter a name for the webhook, such as "Asset deleted."
ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect 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 nameEnter a name for the webhook, such as "Asset status updated."
ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect 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 nameEnter a name for the webhook, such as "Asset created."
ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect the team this webhook is created for.

Comments

Create a Comment

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

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

Delete a Comment

This action module deletes an existing comment.

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

Get a Comment

This action module retrieves details of the specified comment.

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

List Comments

This search module retrieves all comments of the specified asset.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that contains the folder you want to retrieve comments from.
Project IDSelect the project that contains the folder you want to retrieve comments from.
Folder IDSelect the folder that contains the asset you want to list comments from.
Asset IDSelect the asset you want to list comments for.
LimitEnter 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.

ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect or map the team that owns the project that contains the asset you want to update a comment on.
Project IDSelect the project that contains the asset you want to update a comment on.
Folder IDSelect the folder that contains the asset you want to update a comment on.
Asset IDSelect the asset you want to update a comment on.
Comment IDSelect the comment you want to update.
TextEnter the text content of the comment.
TimestampEnter 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 nameEnter the name of the webhook, e.g. Comment Edited.
ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect 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 nameEnter the name of the webhook, e.g. New Comment.
ConnectionFor instructions on creating a connection to Frame.io, see Connect Frame.io to Adobe Workfront Fusion in this article.
Team IDSelect the team this webhook is created for.

Projects

List Projects

This search module retrieves all projects for the specified team.

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