Script Actions [Beta]

Overview

A script action is a type of rule action that can run a custom Node.js script to call the Asana API. Developers can use this feature to deeply automate Asana processes by using custom code and the API.

Why use script actions

Rules are a powerful automation engine within Asana projects. Script actions brings together the simplicity of creating automation on projects with the power of the API. Rules use triggers (events) to initiate an action. These actions have been limited to Asana defined action types. Script actions now make it possible for a developer to define an action type by using the API to perform an action as part of a rule.

This opens up a world of possibilities. For example, perhaps when a form is filled out, you want to validate that one of the custom fields is an email address. A script action can use a regular expression to validate the email address and then leave a comment. Or maybe you want to update an Asana’s goal progress with a specific custom field value from a task. A script action can be used to update a goal progress metric. For more examples and inspiration, check out our example library.

How script actions work

Script actions is a serverless environment provided by Asana to call the API as part of a rule. A developer must authorize the Scripts by Asana app to access script actions from the Actions menu inside a project’s rule builder. After authorizing, the code editor will appear in the rule builder. Developers can write code in their text editor of choice and then copy/paste their code into the code editor or type directly into the code editor. The rule’s trigger will cause the script to run whenever that trigger criteria is met. For more specifics on how to set up scripts, check out our how to guide.

Who can use Script Actions

Script actions are currently available as an Early Access [Beta] feature. This feature is available to customers on Enterprise or Enterprise+ tier. If you are interested in participating in our Early Access [Beta], please complete this form.

For those with access to script actions, script actions can be used by any project member with project editor or project admin permissions. To block access to script actions, the Super Admin in Enterprise+ (or Legacy Enterprise) workspaces can block the Scripts by Asana app.