Bynder modules

In an Adobe Workfront Fusion scenario, you can automate workflows that use Bynder, as well as connect it to multiple third-party applications and services.

For instructions on creating a scenario, see the articles under Create scenarios: 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 Bynder modules, you must have a Bynder account.

Bynder API information

The Bynder connector uses the following:

API version
v4
API tag
v1.25.21

Connect Bynder to Workfront Fusion connect-bynder-to-workfront-fusion

NOTE
Bynder uses the Authorization code / refresh token grant type. This is the only grant type that the Fusion Bynder connector uses.

Create a connection to Bynder from Workfront Fusion

You can create a connection from Workfront Fusion to your Bynder account directly from inside a Bynder module.

  1. In any Bynder module, click Add next to the Connection field.

  2. Select the Bynder domain that you want to connect to.

  3. (Optional) Click Advanced settings, then enter your Client ID and Client Secret.

    For instructions on generating the Client ID and Client Secret, see Generate a Client ID and Client Secret in Bynder (Optional) in this article.

  4. In the login window, enter your username (email address) and password.

  5. Click Continue to create the connection and go back to the module.

Generate a Client ID and Client Secret in Bynder (Optional)

If you want to create a connection using the Client ID and Client Secret, you can generate them from your Bynder account. The Client ID and Client Secret are generated when you create an app in Bynder.

For instructions for creating an app in Bynder, see Oauth 2.0 Apps in the Bynder documentation.

NOTE
  • When creating the app in Bynder, enter the following as the redirect uri:

    • US cluster: https://app.workfrontfusion.com/oauth/cb/workfront-bynder
    • EU cluster: https://app-eu.workfrontfusion.com/oauth/cb/workfront-bynder
    • Azure cluster: https://app-az.workfrontfusion.com/oauth/cb/workfront-bynder
  • Bynder uses the Authorization code / refresh token grant type. This is the only grant type that the Fusion Bynder connector uses.

Bynder modules and their fields

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

Actions

Add a tag to assets

This action module adds a tag to one or more assets

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Tag ID
Enter or map the ID of the tag that you want to add to assets.
Asset IDs
For each asset you want to tag, click Add item, then enter or map the asset ID.

Add assets to a collection

This action module adds one or more assets to a collection.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Collection ID
Enter or map the ID of the collection where you want to add assets.
Asset IDs
For each asset you want to add to the collection, click Add item, then enter or map the asset ID.

Custom API Call

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

When you are configuring this module, the following fields display.

The module returns a status code, along with the headers and body of the API call.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
URL
Enter a path relative to https://{your-bynder-domain}/api/{api-version}/.
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.

Download asset

This action module downloads a single asset.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset you want to download.
Asset version
Enter or map the version of the asset that you want to download. To download the latest version of the asset, leave the field empty.

Read asset metadata

This action module reads the metadata of an asset.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset that you want to retrieve metadata for.
Outputs
Select the information you want included in the output bundle for this module.

Remove a tag from assets

This action module removes a tag from one or more assets

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Tag ID
Enter or map the ID of the tag that you want to remove from assets.
Asset IDs
For each asset you want to remove a tag from, click Add item, then enter or map the asset ID.

Remove assets from collection

This action module removes one or more assets from a collection.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Collection ID
Enter or map the ID of the collection where you want to remove assets.
Asset IDs
For each asset you want to remove from the collection, click Add item, then enter or map the asset ID.

Update asset metadata

This action module updates the metadata of an existing asset.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset that you want to update metadata for.
Fields
Select the fields that you want to enter information for, then enter or map the information that you want to update the metadata with into those fields.
Metaproperties
Select the options that you want to update, then enter or map the information into those properties. Metaproperties are information about the asset that do not represent specific fields in the asset.

Upload asset

This action module uploads a single asset.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Save as

Select how you want to save the file you are uploading.

  • New asset

    Select the fields and metaproperties that you want to enter information for, then enter the information into those fields.

    Enter or map the ID of the Brand you want to use for the uploaded asset.

  • New asset version

    Enter the ID of the asset that you are uploading a new version for.

Source file
Select a source file from a previous module, or map the source file's name and data.
Asynchronous file upload
Enable this option when uploading large files. This prevents large files from blocking scenario execution.

Searches

List record

This search module retrieves all items of a specific type.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Record Type

Select the type of record you want to list.

  • Read all collections

  • Read information about all tags

  • Read all assets of a collection

    Enter or map the ID of the collection that you want to list assets of.

Outputs
Select the fields that you want to include in the module's output.
Limit
Enter or map the maximum number of assets you want the module to return during each scenario execution cycle.

Search Assets

This search module searches for assets base on criteria you supply.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Search criteria

Enter the search criteria.

  • Field

    Select the field that you want to use in your search

  • Logical Operator

    Select the operator that you want to use in your search.

  • Value

    Enter or map the value to look for in the selected field. The value type should be the same as the data type of the selected field.

    For more information on data types, see Item data types.

Result set
Select whether you want to return the first matching asset or all matching assets.
Sort by
Select the field that you want to sort by.
Sort Direction
Select whether you want to sort ascending or descending.
Outputs
Select the fields that you want to include in the module's output.
Limit
Enter or map the maximum number of assets you want the module to return during each scenario execution cycle.

Triggers

Watch assets

This trigger module starts a scenario when an asset is created or updated.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
Event type
Select whether you want to start the scenario when a new asset is created or when an existing asset is updated.
Collections
Select the collection that you want to watch for new assets. To watch all collections, leave this field empty.
Outputs
Select the fields that you want to include in the output.
Limit
Enter the maximum number of records you want the module to return during each scenario execution cycle.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3