Note
If you’re looking for the Asana app in Salesforce AppExchange, you can learn more about the deprecation plan in this FAQ. Going forward, customers should use the Salesforce app in Asana integration.
Salesforce in Asana integration extends our rules core components to Salesforce, so that you can automate workflows between Salesforce and Asana, and keep the latest data in sync in Asana.
Asana Rules are automations that streamline routine tasks. A rule consists of a trigger and an action, an event that activates the rule and an action performed by the rule, respectively. An example of a trigger is When an opportunity is created in Salesforce. An example of an action is Create a task in a specific Asana project.
Salesforce in Asana integration utilizes the trigger Salesforce record created or updated, with many customizable conditions available. Rules can be configured with conditions based on Salesforce object types (e.g. Opportunity, Account) and specific field values across numbers, dates, and picklists.
Users can choose from 2 Salesforce triggers:
Note that Record is created or updated is the trigger that should be used for the Create task and keep in sync action.
When setting your trigger, you can specify certain conditions that should simultaneously be met for the rule to run. If the rule is triggered by an event, but the specified condition is not met, then the rule will not run. For example, for the trigger Salesforce record is created or updated, the following conditions are supported as part of the trigger:
Example: Create a review task when opportunity ARR change is changed to > $10,000
Note that conditions are set within the Salesforce trigger, i.e. they are coupled with the trigger. They cannot be set as a separate condition to the trigger.
See a popular example in action in the "Creating tasks for specific opportunity stages" section.
Salesforce builds upon rule variables. A variable is a way to reference key data from a rule trigger in the rule action.
For example, if a Salesforce trigger is chosen, rule actions can reference the Salesforce opportunity ARR. In rule actions like Create task, fields from the Salesforce record can be mapped using dynamic variables to populate the task name, description, and custom fields. When the rule is triggered by an event in Salesforce, the rule action will pull the value of the variable from Salesforce.
When setting up a rule action, the following Salesforce field types are available as variables to be pulled into Asana task fields:
| Salesforce field type | Asana field type |
| String | Text (task title, description, custom field, comment) |
| Textarea | Text |
| Picklist | Text |
| Date, Datetime | Date/time, text |
| Currency | Number, text |
| Int | Number, text |
| Long | Number, text |
| Percent | Number (1%=1), text |
| Rich textarea | Unformatted text |
The Create a task and keep in sync action pairs with the Salesforce record is created or updated trigger to enable automatic updates from fields in Salesforce to Asana fields through rule actions that map Salesforce variables. When Salesforce fields change, corresponding Asana tasks are automatically updated, ensuring teams always have the latest information without the need for manual updates.
When using the create task and keep in sync action, a Salesforce field will be mapped 1-to-1 with an Asana field. For example, "Account Name" can be mapped 1-to-1 to a text field like "Task Name". However, the create task and keep in sync action will not update a concatenation of text and variables, like "Account: {Account Name}".
Salesforce admins have the required permissions to set up the sync action rule in Asana.
Consider a rule which is designed to create a new task in Asana whenever a new opportunity is created in Salesforce, and to sync the values of the Salesforce opportunity's fields with their corresponding Asana task fields.
The Salesforce opportunity's Name and ARR Change fields would be mapped to the Asana task's Task name and Amount fields, respectively. If the opportunity's name is changed to XYZ, the Asana task's title changes to XYZ automatically. Likewise, any modification of the ARR Change value within Salesforce will automatically be reflected in the Amount field in the Asana task.
While the Create task and keep in sync action is useful for creating tasks for all opportunities, you may want to create and sync tasks only when an opportunity reaches a specific stage (such as "Proposal" or "Negotiation"). This requires setting up two separate rules instead of using the preset action.
Use the two rule approach when you want to:
Important: Single-select and multi-select custom fields are not supported in Salesforce-Asana field syncing.
This rule creates the initial task when an opportunity reaches your target stage.
This rule keeps the task fields synchronized with Salesforce data
For opportunities in the Proposal stage.
Rule 1:
Rule 2:
This setup ensures tasks are only created when opportunities reach the "Proposal" stage, while keeping all relevant fields synchronized throughout the opportunity lifecycle.
We recommend working with your Salesforce admin on installation steps and referring to this more detailed installation guide documentation.
An Asana user can create and save the rule if the following conditions are satisfied:
The user has authorized via OAuth into their Salesforce account.
The user has the following Salesforce permissions. We recommend working with your Salesforce admin to set up these permissions:
Customize Application
Run flows
Manage flows
Modify Metadata Through Metadata API Functions
Enable System Mode Flow Activation
An Asana user can link Salesforce records to an Asana task if the following conditions are satisfied:
The user has authorized via OAuth into their Salesforce account.
The user has access to those specific records in Salesforce.
Data is communicated securely through the Salesforce API integration. User permissions for accessing linked Salesforce data follow Asana's standard permissions model based on task access.