DocumentationWorkfrontWorkfront Guide

Bynder modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

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.

If you need instructions on creating a scenario, see Create a scenario in Adobe Workfront Fusion.

For information about modules, see Modules in Adobe Workfront Fusion.

Access requirements

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

Adobe Workfront plan*
Pro or higher
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime Adobe Workfront plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

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

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:
https://app.workfrontfusion.com/oauth/cb/workfront-bynder

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 in Adobe Workfront Fusion.

Actions

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.

Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.

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
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.

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.

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.

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.

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.

Add a tag to assets

Add 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.

Remove a tag from assets

Remove 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.

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.

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.

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 for 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.
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 in Adobe Workfront Fusion.

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.
Collections
Select the collection that you want to watch for new assets. To watch all collections, leave this field empty.
Limit
Enter the maximum number of records you want the module to return during each scenario execution cycle.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43