ÃÛ¶¹ÊÓƵ

DocumentationWorkfrontÃÛ¶¹ÊÓƵ Workfront Fusion

ÃÛ¶¹ÊÓƵ Lightroom modules

Last update: Thu May 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In an ÃÛ¶¹ÊÓƵ Workfront Fusion scenario, you can automate workflows that use ÃÛ¶¹ÊÓƵ Lightroom, as well as connect it to multiple third-party applications and services.

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
ÃÛ¶¹ÊÓƵ Workfront package Any
ÃÛ¶¹ÊÓƵ Workfront license

New: Standard

Or

Current: Work or higher
ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion.

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

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

Prerequisites

Before you can use the ÃÛ¶¹ÊÓƵ Lightroom connector, you must ensure that the following prerequisites are met:

ÃÛ¶¹ÊÓƵ Lightroom API information

The ÃÛ¶¹ÊÓƵ Lightroom connector uses the following:

Base URL
https://lr.adobe.io
API tag
v1.17.128

Create a connection to ÃÛ¶¹ÊÓƵ Lightroom

To connect to ÃÛ¶¹ÊÓƵ Lightroom, you must first configure an OAuth app in the ÃÛ¶¹ÊÓƵ Admin Console. After this app is configured, you can create connections from Workfront Fusion.

Configure an OAuth application in the ÃÛ¶¹ÊÓƵ Admin Console

  1. Begin configuring an OAuth Web App in the ÃÛ¶¹ÊÓƵ Admin Console.

    For instrtuctions, see in the ÃÛ¶¹ÊÓƵ developer documentation.

  2. When configuring the OAuth Web App, enter the following values:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Scopes
    • ÃÛ¶¹ÊÓƵID
    • lr_partner_rendition_apis
    • openid
    • offline_access
    • lr_partner_apis
    Redirect URI https://app.workfrontfusion.com/oauth/cb/adobe-lightroom5
    Redirect URI pattern https://app\.workfrontfusion\.com/oauth/cb/adobe-lightroom5

Create a connection to ÃÛ¶¹ÊÓƵ Lightroom from Workfront Fusion

To create a connection for your ÃÛ¶¹ÊÓƵ Lightroom modules:

  1. In any ÃÛ¶¹ÊÓƵ Lightroom 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 layout-auto html-authored no-header
    Connection name Enter a name for this connection.
    Environment Select whether you are connecting to a production or non-production environment.
    Type Select whether you are connecting to a service account or a personal account.
    Client ID Enter your ÃÛ¶¹ÊÓƵ Client ID. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console
    Client Secret Enter your ÃÛ¶¹ÊÓƵ Client Secret. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console

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

ÃÛ¶¹ÊÓƵ Lightroom modules and their fields

When you configure ÃÛ¶¹ÊÓƵ Lightroom modules, Workfront Fusion displays the fields listed below. Along with these, additional ÃÛ¶¹ÊÓƵ Lightroom 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

Other

Health check

This action module retrieves a Lightroom server version ID, proving whether the Lightroom service is currently running.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Credentials

If you want to supply specific credentials to ensure that a specific server is running, click Add item and enter the credentials.

Authorization headers are added automatically.

Retrieve user catalog metadata

This action module retrieves metadata from a catalog in ÃÛ¶¹ÊÓƵ Lightroom. A catalog contains assets, albums, or other resources.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Credentials

If you want to supply specific credentials to ensure that you can access the correct user account, click Add item and enter the credentials.

Authorization headers are added automatically.

Assets

Create an asset original file

This action module creates and uploads an original file for an asset.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the asset.
Asset ID
Enter or map the ID of the asset that you want to create and upload a file for.
Length of content in bytes
Enter or map the length of the content in bytes.
Byte range
Enter or map the byte range for the request, including first and last bytes and entity length as defined in RFC 2616. This information should be included only when the data is too large to be uploaded in a single call.
Content type
Select the content type for the new file.

Create an asset

This action module creates a new asset with initial metadata and import information.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog where the asset will be created.
Asset ID
Enter or map the ID of the new asset.
Asset type
Select whether the asset is an image or a video.
Datetime user created
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00.
Datetime user updated
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00.
Date captured
Enter or map the capture date of the asset with the format YYYY-MM-DDT00:00:00-00:00. This will be set by the server if the Date captured is set to 0000-00-00T00:00:00.
File name
Enter or map the file name of the asset that you are importing into Lightroom.
Name of Device Imported On
Enter or map the name of the device that imports the asset.
Account ID of User Who Imported
Enter or map the ID of the user that imports the asset.
Import Timestamp
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00.

Create an asset external XMP develop setting file

This action module supports two workflows: uploading the external XMP develop settings file for the asset, or creating an external XMP develop settings file by copying from another asset’s external xmp develop setting file.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Content Length in Bytes
Enter or map the length of the content in bytes.
Upload new or copy XMP/develop file
Select whether you are uploading a new file, or copying a file from an existing asset.
Catalog ID
Enter or map the ID of the catalog where you want to create the asset.
Asset ID
Enter or map the ID of the asset that you want to upload or copy a file to.
Link to XMP/develop file

Enter or map a link to the file you want to upload or copy.

This file must be JSON if copying a file, or XML if uploading a file.

Generate renditions for an original file

This action module asynchronously generate renditions for an original file.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Rendition Type(s) (semi-colon separated)

Enter the rendition type for the rendition you want to create. If entering more than one type, separate them with a semicolon (;).

Possible types:

  • fullsize
  • 2560
Length of content in bytes
Enter or map the length of the content in bytes.
Catalog ID
Enter or map the ID of the catalog where you want to generate the renditions.
Asset ID
Enter or map the ID of the asset that you want to create a rendition of a file for.

Get a catalog asset

This action module retrieves information about a single asset in a catalog. The catalog must be owned by the user whose credentials are represented in the connection used in this module.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the asset.
Asset ID
Enter or map the ID of the asset that you want to retrieve information for.

Get the latest asset external XMP develop setting file

This action module retrieves the most recent asset external XMP setting file.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the asset associated with the XMP develop setting file.
Asset ID
Enter or map the ID of the asset associated with the XMP develop setting file.

Get latest asset rendition

This action module retrieves the latest asset rendition of the specified type.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the asset that you want to retrieve a rendition for.
Asset ID
Enter or map the ID of the asset that you want to retrieve a rendition for.
Rendition type
Select the type of rendition that you want to retrieve.

Retrieve assets

This action module retrieves assets owned by the by the user whose credentials are represented in the connection used in this module.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the asset.
Starting timestamp
Enter or map a timestamp. The module returns records that have been updated after this time stamp.
Return assets captured before given time

Enter a date with the format YYYY-MM-DDT00:00:00. The module returns results captured before this date.

This field cannot be used with the field Return assets captured after given time.

Return assets captured after given time

Enter a date with the format YYYY-MM-DDT00:00:00. The module returns results captured before this date.

This field cannot be used with the field Return assets captured before given time.

Maximum number of returned assets
Enter the maximum number of records you want the module to return during each scenario execution cycle.
SHA256 Hash value of original file
Enter or map the hash value of the original file. Assets with a matching hash are returned.
Hide assets that are inside stacks?"
Select Yes to hide assets inside stacks (assets inside stacks are not returned). Select No to include assets inside stacks in results.
Asset subtype values
Enter or map a semicolon-separated list of subtype values to return.
Asset IDs
Enter or map up to 100 asset IDs, separated by commas.
Types of assets to exclude
Select if you want to exclude complete or incomplete assets. To include all assets, leave this field blank.
Group values
Enter or map a semicolon-separated list of group values.
Name values
Enter or map a semicolon-separated list of name values.
Favorite status
Enter or map the favorite status that you want to return results for.

Albums

Add assets to an album

This action module adds one or more assets to the specified album. You can add up to 50 assets in one execution cycle.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the album that you want to add assets to.
Album ID
Enter or map the ID of the album that you want to add assets to.
Assets
For each asset that you want to add to the album, click Add item and enter the following fields.
Asset ID
Enter or map the ID of the asset you want to add to the album
Is this asset an album cover?
Select whether you want this asset to be displayed as the image that represents the album.
Order
Specify the order of the asset.
Service Payload
Enter or map any metadata you want to include with the asset. This must be a single text string with a maximum length of 1-24 characters.
Remote ID
Enter an identifier for the asset.

Create an album

This action module creates a new album in Lightroom.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog where you want to create an album.
Album ID
Enter or map an ID for the new album.
Subtype
Select the subtype for the album.
Service ID
Enter the API key of the service that is creating the album.
Date User Created
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00Z.
Date User Updated
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00Z.
Album Name
Enter or map a name for the new album.
Cover ID
Enter or map the ID of an asset to use as the cover of this album.
Parent ID
Enter or map the ID of the parent for this album.
Service Payload
Enter or map album metadata as a string.
Remote ID
Enter an identifier for the asset.
Created date
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00Z.
Updated date
Enter or map a date with the format YYYY-MM-DDT00:00:00-00:00Z.
Is the album deleted?
Enable this option if the externally affiliated content was deleted.
URL of location to edit affiliated content
If there is a URL where users can edit content of this album, enter the URL here.
URL of location to view affiliated content
If there is a URL where users can view content of this album, enter the URL here.

Delete an album

This action module deletes an album.

The deleted album must have been created by the same client app that is now deleting it, and it must be of subtype project or project_set.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains album you want to delete.
Album ID
Enter or map the ID of the album you want to delete.
Delete child albums?
Select whether you want to delete child albums of the deleted album.

Get an album

This action module retrieves the specified album.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains album you want to retrieve.
Album ID
Enter or map the ID of the album you want to retrieve.

List assets of an album

This action module retrieves a list of assets in the specified album.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains the album.
Album ID
Enter or map the ID of the album for which you want to list assets.
Capture Assets Before Time

Enter a date with the format YYYY-MM-DDT00:00:00. The module returns results captured before this date.

This field cannot be used with the field Return assets captured after given time.

Capture Assets After Time

Enter a date with the format YYYY-MM-DDT00:00:00. The module returns results captured before this date.

This field cannot be used with the field Return assets captured before given time.

Ending Asset Order Value

Enter or map the order value of the ending asset.

This field can only be used with the field Capture Assets After Time.

Starting Asset Order Value

Enter or map the order value of the starting asset.

This field can only be used with the field Capture Assets BEfore Time.

Number of Assets to Return (1-500)
Enter the maximum number of records you want the module to return during each scenario execution cycle. This number must be between 1-500.
Hide assets that are inside stacks?"
Select Yes to hide assets inside stacks (assets inside stacks are not returned). Select No to include assets inside stacks in results.
Subtype Values (semi-colon separated)
Enter or map a semicolon-separated list of subtype values to return.
Flag Values (semi-colon separated)
Enter or map a semicolon-separated list of flag values to return.
Additional Data Fields to Include (semi-colon separated)
If asset is included, all fields are included, otherwise, only id and self href link are returned.
Types of assets to exclude
Select if you want to exclude complete or incomplete assets. To include all assets, leave this field blank.
Asset IDs
Enter or map up to 100 asset IDs, separated by commas.
Filter out album assets based on presentation filters
When this field is set to 'true', it filters out all the album assets based on the presentation filters set on the album. With this parameter, rejected assets always get filtered out irrespective of settings in presentation filters. Presentation filters are not applied when any value other than 'true' is set for album_filters. Default behavior is to display all assets. This parameter cannot be used along with flag parameter.

Retrieve albums

This action module retrieves a list of albums in the specified catalog.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains albums you want to retrieve.
Subtypes
Enter or map a semicolon-separated list of subtype values to return.
Name of album to precede current results
If you are paginating your results, enter or map the name of the last album on the preceding page.
Number of Albums to Return
Set the maximum number of assets that Workfront Fusion will return during one execution cycle. The default value for this field is 100.This module may return more albums than this limit if multiple albums at the limit boundary have the same name_after value.

Update album

This action module updates the specified album.

The updated album must have been created by the same client app that is now updating it, and it must be of subtype project or project_set.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ Lightroom, see Create a connection to ÃÛ¶¹ÊÓƵ Lightroom in this article.
Catalog ID
Enter or map the ID of the catalog that contains album you want to update.
Album ID
Enter or map the ID of the album you want to update.
Other fields
For descriptions of other fields in this module, see Create an album in this article.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3