Adobe Workfront Planning modules

With the Adobe Workfront Planning modules, you can trigger a scenario when events occur in Workfront Planning. You can also create, read, update, and delete records, or perform a custom API call to your Adobe Workfront Planning account.

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

You must have the following to access Workfront Planning:

  • A new Workfront package and license. Workfront Planning is not available for legacy Workfront packages or licenses.
  • A Workfront Planning package.
  • Your organization’s instance of Workfront must be onboarded to the Adobe Unified Experience.

Adobe Workfront Planning API information

The Adobe Workfront Planning connector uses the following:

Base URL
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
API tag
v1.13.7

Create a connection to Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

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

  1. In any Adobe Workfront Planning 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 5-row-2 6-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 care connecting to a service account or a personal account.

    Client ID

    (Optional)

    Enter your Adobe Client ID. This can be found in the Credentials details section of the Adobe Developer Console.

    Client Secret

    (Optional)

    Enter your Adobe Client Secret. This can be found in the Credentials details section of the Adobe Developer Console.
    Authentication URL

    Enter the URL that your instance of Workfront will use to authenticate this connection.

    The default value is https://oauth.my.workfront.com/integrations/oauth2.

    Host prefix

    Enter your host prefix.

    The default value is origin-.

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

Adobe Workfront Planning modules and their fields

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

Triggers

Watch Events

This trigger module starts a scenario when a record, record type, or workspace is created, updated, or deleted in Workfront Planning.

Webhook
Select the webhook that you want to use, or click Add to create a new one.
Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Object type
Select whether you want to watch records, record types, or workspaces.
State

Select whether you want to watch the old state or the new state.

  • New state

    Trigger a scenario when the record changes to a given value.

  • Old state

    Trigger a scenario when the record changes from a given value.

Workspace
If watching records, select the Workspace you want to watch for records.
Record type
If watching records, select the type of record you want to watch for.
Events filters

You can set filters to watch for only records that meet criteria you select.

For each filter, enter the field you want the filter to evaluate, the operator, and the value that you want the filter to allow. You can use more than one filter by adding AND rules.

Note: You cannot edit filters in existing Workfront webhooks. To set up different filters for Workfront event subscriptions, remove the current webhook and create a new one.

For more information on event filters, see Event subscription filters in the Workfront > Watch Events modules in the Workfront modules article.

Objects to watch
Select whether you want to watch for new. updated, new and updated, or deleted records.
Exclude updates made by this connection
Enable this option to prevent the scenario from triggering when a change is made by the connection used by this module. This prevents another instance of the scenario being triggered if this scenario performs a triggering action.

Actions

Delete a record type

This action module deletes a single record type in Workfront Planning by its ID.

WARNING
Deleting a record type in Workfront Planning also deletes all records in the record type table.
Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Record type ID
Enter or map the ID of the record type you want to delete.

Make a custom API call

This module makes a custom API call to the Adobe Workfront Planning API.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
URL
Enter a path relative to https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
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
For each key/value pair that you want to add to the query string, click Add item and enter the key and 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.

Searches

Search records

This action module retrieves a list of records based on criteria you specify.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Workspace
Enter or map the Workspace that contains the records that you want to search.
Record type
Select the record type that you want to search.
Record Fields
For each field that you want to use in your search, locate that field, select the opertor, and enter or map the value that you want to search for. Field are available based on the record type selected.
Condition for filters

Select the condition for your filters:

  • AND

    The module returns records that meet all of the field values you selected.

  • OR

    The module returns records that meet any of the field values you selected.

Limit
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Uncategorized

Create a record

This action creates a single record in Workfront Planning.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Record type ID
Enter or map the type of record you want to create. Available record types are based on your Workfront Planning account.
Other fields
Enter the values that you want the new record to have. These fields are based on the record type you selected.

Delete a record

This action module deletes the specified record in Workfront Planning.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Record ID
Enter or map the ID of the record you want to delete.

Get a record

This action module retrieves a single record from Adobe Workfront Planning, specified by its ID.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Record ID
Enter or map the ID of the record you want to retrieve.

Get records by record type

This action module retrieves all records of the specified type.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Workspace
Select or map the workspace that contains the records you want to retrieve.
Record type
Select the type of record that you want to retrieve.

Get record types

This action module retrieves a list of record types in an Adobe Workfront Planning account.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Workspace
Select or map the workspace that contains the record types you want to retrieve.

Update record

This action updates a single record in Workfront Planning.

Connection
For instructions on creating a connection to Adobe Workfront Planning, see Create a connection to Adobe Workfront Planning in this article.
Record ID
Enter or map the type of record you want to update . Available record types are based on your Workfront Planning account.
Other fields
Enter the new values that you want the record to have. These fields are based on the record type you selected.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3