---
schema_version: "1"
id: 0e83b6b6b0af50d17aa7d11c6e85085f4be683e4949f904dd6502b9ff9124518
title: Asana Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/automate_flow_ref_third_party_asana.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.automate_flow_ref_third_party_asana.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 3c31a1a675fea8d16b291b792df911582442061d6b3cda4b99058ab43f639b9d
description: Connect to an external Asana account. Perform tasks like creating projects or updating tasks. Use Asana as a data source (trigger) or a data target (action).
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# Asana Connector

Connect to an external Asana account. Perform tasks like creating projects or updating tasks. Use Asana as a data source (trigger) or a data target (action).

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=platform.flow_ref_supported_editions.htm&amp;release=264.0.0&amp;type=5" title="Learn about the editions and user interfaces that support Flow Builder. Some Flow Builder features integrate with other Salesforce products that require additional licenses.">View supported editions.</a></td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">This feature requires the MuleSoft for Flow: Integration add-on. Exceptions are segment-triggered flows, activation-triggered flows, and broadcast flows, which don't require the MuleSoft for Flow: Integration add-on. <strong>Professional</strong> Edition requires the API access add-on. To purchase an add-on, contact your Salesforce account executive.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">MuleSoft for Flow: Integration features used with Agentforce require the Foundations or Agentforce 1 edition. To purchase these editions, contact your Salesforce account executive.</td></tr></tbody></table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)

Note You can edit or delete connections only in the Automation app.

## Connections

Connect to a source or target system by using its standard connection or an existing external named credential. You can connect to multiple systems within a flow and reuse each connection. You can create connections in the [Integrations tab](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections.htm&release=264.0.0&type=5 "The Integrations tab includes a list of all the connections for your org.") or in Flow Builder.

**Standard Connection**

This system uses Bearer authentication.

Bearer authentication sends a header named Authorization with a value of Bearer and a token with every request.

This system requires this credential information for its [connections](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections_create_connection.htm&release=264.0.0&type=5).

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d47716e111">FIELD</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d47716e114">DESCRIPTION</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e111 ">Connection Name</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e114 ">
              <p dir="ltr">Enter a unique connection name that helps you remember the details of this
                connection. Salesforce hides the credentials after you create the connection. Reuse
                connections as needed.</p>
              <p style="margin-bottom:0;" dir="ltr">Anyone with the Manage Integration Connections permission can see and use all
                connections in the org.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e111 ">Token</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e114 ">
              <p style="margin-bottom:0;">Enter the bearer token to use to authenticate the requests. For information about how to
                create the bearer token, refer to the external system's documentation.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="FIELD" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e111 ">URL</td>

            <td data-label="DESCRIPTION" class="slds-cell-wrap" style="vertical-align:top;" headers="d47716e114 ">
              <p style="margin-bottom:0;">Enter the URL of your instance.</p>
            </td>

          </tr>
        </tbody>
      </table>

**Named Credential Connection**

Select a pre-existing named credential from Setup to use for your external system connections.

Before connecting to your external system with a named credential, first create or use an existing authenticated [named credential and external credential that is enabled for your users.](https://help.salesforce.com/s/articleView?id=xcloud.nc_named_creds_and_ext_creds.htm&type=5&language=en_US)

To ensure a successful [connection](https://help.salesforce.com/s/articleView?id=platform.automate_ala_connections_create_connection.htm&release=264.0.0&type=5 "Select a named credential from Setup to use for your external system connections.") for use in a flow, use only one principal for each named credential.

- Use the same name for the named credential and its related objects, such as the external credential and external authentication identity providers. Labels for these objects can differ.
- Assign the user creating the connection the required user permission for the principal. Without this permission, the connection test fails and the connection remains inactive.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_important.png)

Important

When you create a connection with an existing named credential, note these behaviors:

- Manage the named credential’s read-only details in Setup, not the Integrations tab. On the Integrations tab, you can only edit the connection's Connection Name and Description.
- Perform reconnections for the named credential in Setup. The Reconnect button isn’t visible on the Details page.
- Delete associated named credentials in Setup. Deleting a connection doesn't remove the credential.

## Triggers

A trigger initiates the flow when a specified event occurs. Triggers are important for automating business processes because they react to real-time data changes in various systems. For more information about triggers, refer to [Create a Flow with a Connector as a Trigger](https://help.salesforce.com/s/articleView?id=platform.automate_build_flow_esct_third_party_as_trigger.htm&release=264.0.0&type=5 "To trigger a flow when a change happens in a third-party system, use an External System Change-Triggered flow. A poller checks for new records on a schedule and creates flow interviews when records are found. Create the flow from scratch or from a template.").

These Asana triggers are available in Flow Builder.

- On Completed Task
- On New Comment
- On New Project
- On New Story
- On New Task
- On New or Update Project
- On New or Update Task

## Actions

An action performs a specific task or operation within a target system. Use actions to automate tasks across different systems without manual intervention, based on conditions set in the flow. For more information about actions, refer to [Create a Flow with a Connector as an Action](https://help.salesforce.com/s/articleView?id=platform.automate_build_flow_esct_third_party_as_action.htm&release=264.0.0&type=5 "To integrate your flow with an external system, add MuleSoft for Flow: Integration connectors as actions to all existing flow types. You can add connectors to flows that trigger external system changes, records, schedules, Data Cloud-triggered flows, or autolaunched flows.").

These Asana actions are available in Flow Builder.

- Add Project To Task
- Add Tag To Task
- Add Users To A Project
- Create Project
- Create Tag
- Create Task
- Create Task With Custom Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    In the **Project Ids** field, enter the list of project IDs in the format `["id1", "id2"]`.
- Get A Story
- Get Multiple Tags
- Get Projects
- Get Stories From A Task
- Get Tag By ID
- Get Task By ID
- Get Task Dependencies
- Get Task Dependents
- Get Tasks
- Get Tasks From A Project
- Get Teams In A Workspace
- Get User By ID
- Get Users
- Get Workspace By ID
- Get Workspaces
- Remove Users From A Project
- Search Tasks
- Set Task Dependencies
- Set Task Dependents
- Update Task Custom Fields With ProjectIds
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    This action supports schema resolution using project information instead of a sample task. The inputs are:
    
    - projectIds (Used only for schema resolution)
        - A constant list of project IDs must be provided by the user.
        - These project IDs are used only for schema resolution.
        - The keyword `ALL` can be provided to fetch custom fields from all projects. This option allows flow creation without requiring hardcoded projectId values for schema resolution.
    - taskId (Task to be updated)
        - A variable value can be provided by the user.
        - The task identified by this ID will be updated with the user-provided data at runtime.
    
    Use this action when a project or list of projects (or an allowed set of projects) is known at design time and can be used for schema resolution. Alternatively, the `ALL` keyword can be used to fetch custom fields from all projects, eliminating the need to specify any project values during design time.
    
    Note that:
    
    - All custom fields will be fetched during schema resolution.
    - At runtime, only the custom fields applicable to the provided taskId will be updated with the user-specified values.
    - Any non-applicable custom fields will be ignored.
- Update Task Custom Fields With Sample TaskId
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    This action supports schema resolution using a sample task while allowing a variable task ID at runtime. The inputs are:
    
    - sampleTaskId (Used only for schema resolution)
        - A constant value must be provided by the user.
        - The Task GID must belong to the same project or an allowed set of projects as the runtime Task GID.
        - This task ID is used exclusively for schema resolution.
    - taskId (Task to be updated)
        - A variable value can be provided by the user.
        - The task identified by this ID will be updated with the user-provided data at runtime.
    
    Use this action when custom fields need to be updated and a sample task ID belonging to the same project (or an allowed set of projects) as the runtime task can be easily provided. It is suitable for simple workflows where schema resolution can rely on a known task.
- Update Task Standard Fields
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    This action supports updates to standard (non-custom) fields only.
    
    Use this action when no custom fields need to be updated. The action expects taskId as input. The taskId may be provided either as a variable or as a constant. No additional inputs are required for schema resolution, as only standard task fields are supported.
- Update Project
- Update Tag
- Update Task
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)
    
    Note
    
    This action supports updates to both standard and custom fields.
    
    Use this action only when the taskId is provided as a hardcoded constant in the flow. Providing a hardcoded taskId enables schema resolution and is required for this action.
- Update Workspace

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_tip.png)

Tip For more information about the API, see the external system's API documentation.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_important.png)

Important

For information about specific limitations for connections and third-party connectors, see [MuleSoft for Flow: Integration Limits & Considerations](https://help.salesforce.com/s/articleView?id=platform.automate_flow_considerations_mulesoft_for_flow_limits.htm&release=264.0.0&type=5 "When establishing connections to external systems, keep these limitations in mind.").