View as Markdown
Asana icon

Asana ACTION

Create Task

Creates a new task in Asana. Use this to add a standalone task to a workspace or project. For subtasks, use Create Subtask instead; for template-based tasks, use Create Task from Template. Returns the new task record including its gid. Example: call with taskName: 'Review Q3 report', workspace: '1200123456789012', due_on: '2026-10-01' → returns {gid: '1202345678901234', name: 'Review Q3 report', resource_type: 'task'}. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Asana account once, then configure and run Create Task from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "asana-create-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    asana: { authProvisionId: "apn_xxxxxxx" },
    workspace: "Workspace",
    project: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Task inputs
Property Type Description
workspace Workspace string
GID of the workspace, e.g. 1200123456789012. Use List Workspaces to find available workspace GIDs.
Required
project Project string
List of projects. This field uses the project GID (e.g. 1204567890123456). Use Search Projects to find available project GIDs (the gid field).
Required
taskName Name string
Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
Required
tags Tags string[]
List of tags. This field uses the tag GID (e.g. 1202345678901234). Use List Tags to find available tag GIDs (the gid field).
Optional
assignee Assignee string
Gid of a user. Use List Users to find available user GIDs.
Optional
assignee_section Assignee Section string
The assignee section is a subdivision of a project that groups tasks together in the assignee's "My Tasks" list (a section GID, e.g. 1203456789012345). Use Get Tasks From Task List with optFields including assignee_section to retrieve the authenticated user's own My Tasks section GIDs. GIDs for another assignee's sections must come from that person's own My Tasks list, not from this account.
Optional
completed Completed boolean
True if the task is currently marked complete, false if not.
Optional
due_at Due At string
The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with due_on.
Optional
due_on Due On string
The localized date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format and should not be used together with due_at.
Optional
followers Followers string[]
An array of strings identifying users. These can either be the string "me", an email, or the gid of a user (e.g. 1198765432109876). Use List Users to find available user GIDs.
Optional
html_notes HTML Notes string
The notes of the text with formatting as HTML.
Optional
notes Notes string
Free-form textual information associated with the task (i.e. its description).
Optional
parent Parent string
Gid of the parent task, e.g. 1202345678901234. Use Search Tasks to find available task GIDs.
Optional
start_on Start On string
The day on which work begins for the task , or null if the task has no start date. This takes a date with YYYY-MM-DD format.
Optional
custom_fields Custom Fields string
An object where each key is a Custom Field gid and each value is an enum gid, string, or number: E.g. { "4578152156": "Not Started", "5678904321": "On Hold" }
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
asana-create-task
Version
1.0.0
App
Asana
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes