Skip to main content

​
Overview

Gradial’s Workfront integration allows you to sync tasks from your Workfront instance into Gradial to drive collaboration, reporting, and automation across your marketing workflows.

​
With this integration, you can:

  • Ingest Workfront tasks into Gradial with full context
  • Filter tasks using any standard or custom Workfront fields
  • Test queries before syncing to confirm your configuration
  • Map Workfront tasks to Gradial workspaces for automated synchronization
  • Trigger Gradial automations when Workfront tasks are created or updated

​
Prerequisites

Before connecting Workfront to Gradial, gather the following based on the authentication method you choose.

​
Required for all setups

  • Workfront domain – e.g., https://your-company.my.workfront.com
  • Workfront service account – the Workfront user identity Gradial will connect as
    • This should be a dedicated integration/service account, not a personal user
    • Gradial does not need access to the email inbox associated with this account
    • A Workfront system admin can create or assign this user
    • The account must have visibility into all tasks and projects you intend to sync

​
Access & permissions for the service account

The service account must have sufficient permissions for Gradial to ingest and update tasks. At minimum, it must be able to:
  • Read tasks, including all relevant fields and custom fields
  • Comment on tasks
  • Reassign tasks or update task assignments when configured
These permissions may be granted through:
  • Workfront Access Levels
  • Project- or portfolio-level sharing
  • Object-level permissions
For more details, see Adobe Workfront’s documentation on Access Levels and Permissions in the Adobe documentation portal. Your Workfront administrator can configure these permissions based on your organization’s governance model.

​
If using API Key (Username + Password)

  • Service account email
  • API Key generated from the service account’s Workfront settings

​
If using OAuth 2.0 JWT (Server-to-Server)

  • Adobe Workfront OAuth application with JWT flow enabled
  • Client ID
  • Client Secret
  • Customer ID
  • User ID (service account)
  • Private Key (PEM)
Use API Key if your Workfront instance has not migrated to Adobe Unified Access.
Use OAuth 2.0 JWT if your organization enforces Adobe-identity-based authentication.

​
Connect Workfront to Gradial

​
1. Add the Workfront integration

  1. Go to Integrations in the Gradial sidebar.
  2. Select Adobe Workfront.
  3. Click Add Integration.

​
2. Select authentication method

You will be prompted to choose between:
  • API Key
  • OAuth 2.0 JWT (Server-to-Server)

​
Option A — Connect Using API Key

​
Required fields

  • Workfront Base URL
  • Service account username
  • API Key

​
Steps

  1. Enter your Workfront URL.
  2. Enter the service account email.
  3. Paste your API Key.
  4. Click Validate Connection.
Once saved, credentials are stored securely and cannot be viewed.
To modify credentials, create a new integration.

​
Option B — Connect Using OAuth 2.0 JWT (Server-to-Server)

OAuth 2.0 with JWT enables secure server-to-server authentication using an Adobe-registered OAuth application.

​
Required fields

  • Client ID
  • Client Secret
  • Customer ID
  • User ID (service account)
  • Private Key (PEM)
  • Workfront Base URL

​
Steps

  1. Select OAuth 2.0 JWT (Server-to-Server).
  2. Enter the Client ID and Client Secret.
  3. Enter the Customer ID and User ID.
  4. Paste the Private Key (PEM)
  5. Click Validate Connection.

​
3. Configure routes

Routes determine how Workfront tasks are filtered and where they appear in Gradial.
  1. Under Route Configuration, click Add Route.
  2. Provide a Route Name and optional Description.
  3. Under Workfront Task Filters, define criteria:
    • Field (e.g., Project ID, Assigned To ID, Status, Priority)
    • Operator (e.g., Equals, Contains, In, Not In)
    • Value
  4. Add multiple filters to apply AND logic.
  5. Click Test Query to preview matching tasks.
“No tasks found” may simply mean your filters match zero tasks.
This does not indicate an error.

​
4. Select Gradial destination

  1. Under Gradial Destination, choose a Target Workspace.
  2. Tasks matching your filters will appear in the workspace and sync automatically.

​
5. Save your configuration

Click Update Integration to finalize your setup.
Gradial will begin syncing tasks according to your filters and mapping.

​
Troubleshooting

​
Connection succeeds but no tasks are returned

  • Confirm field names and values
  • Broaden your filter criteria
  • Ensure the service account has visibility into the tasks or projects

​
API Key or OAuth connection fails

  • Verify your Workfront domain
  • Regenerate your API key (if applicable)
  • Verify OAuth credentials
  • Confirm the service account is active
  • Ensure the OAuth app supports JWT Bearer Flow

​
Support

Need help configuring or troubleshooting?