Skip to content

Asana Task Create

Overview

The Asana Task Create node creates a new task in a specified Asana project using the Asana REST API. It requires an Asana personal access token or OAuth credential configured in the workflow's credential store. Use this node when a battle outcome, workflow step, or external trigger should produce a trackable action item in Asana. If the API call fails (e.g. invalid project GID, auth error, rate limit), the node emits on the error port with the raw API error details.

Configuration

FieldTypeRequiredDescription
credentialIdstringYesID of the stored Asana credential (personal access token or OAuth2 connection) used to authenticate API requests.
projectGidstringYesThe GID of the Asana project where the task will be created. Found in the project URL.
taskNamestringYesName of the task to create. Supports template expressions (e.g. input.battleTitle placeholders) to inject upstream data.
descriptionstringNoPlain-text or HTML notes for the task body. Supports template expressions.
assigneeEmailstringNoEmail address of the Asana workspace member to assign the task to. If omitted, the task is unassigned.
dueOnstringNoDue date in YYYY-MM-DD format. Supports template expressions for dynamic dates.
priorityenumNoMaps to a custom field or tag representing priority. Accepted values: low, medium, high.
sectionGidstringNoGID of the project section to place the task in. If omitted, the task lands in the default section.

Inputs

PortTypeDescription
inputobjectTrigger signal and contextual data from the upstream node. Fields are accessible in template expressions throughout the config.

Outputs

PortTypeDescription
outputobjectEmitted on successful task creation. Contains the created task object returned by the Asana API, including gid, name, permalink_url, and created_at.
errorobjectEmitted when the Asana API returns an error or the request fails. Contains statusCode, message, and the raw API error body.

Example

json
{
  "nodeType": "asana_task_create",
  "config": {
    "credentialId": "cred_asana_prod_01",
    "projectGid": "1204872349812340",
    "taskName": "Review battle result: {{input.battleTitle}}",
    "description": "Battle completed on {{input.completedAt}}.\nWinner: {{input.winner}}\nScore: {{input.score}}",
    "assigneeEmail": "[email protected]",
    "dueOn": "{{input.reviewDeadline}}"
  }
}