View as Markdown
Asana icon

Asana ACTION

Create Project

Creates a new project in an Asana workspace or team. Use this to set up a new initiative, sprint, or work stream. For organization workspaces you must supply a team GID (use List Teams to find it). Returns the new project record including its gid. Example: call with projectName: 'Q4 Marketing Campaign', workspace: '1200123456789012', team: '1203456789012345', defaultView: 'board' → returns {gid: '1204567890123456', name: 'Q4 Marketing Campaign'}. 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 Project 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-project",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    asana: { authProvisionId: "apn_xxxxxxx" },
    workspace: "Workspace",
    team: "Team",
  },
})

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 Project inputs
Property Type Description
workspace Workspace string
GID of a workspace. Use List Workspaces to find available workspace GIDs.
Required
team Team string
The team that this project is shared with. If the workspace for your project is an organization, you must supply a team to share the project with
Required
projectName Name string
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
Required
notes Notes string
Free-form textual information associated with the project (ie., its description).
Required
color Color string
The color associated with the status update
Optional
title Title string
The title of the project status update.
Optional
defaultView Default View string
The default view (list, board, calendar, or timeline) of a project
Optional
privacySetting Privacy Setting string
The privacy setting of the project. Note: Administrators in your organization may restrict the values of privacy_setting.
Optional
archived Archived boolean
Archived projects do not show in the UI by default and may be treated differently for queries
Optional
dueOn Due On string
The day on which this project is due. This takes a date with format YYYY-MM-DD.
Optional
startOn Start On string
The day on which work for this project begins. This takes a date with format YYYY-MM-DD. Due On must be present in the request when setting or unsetting the Start On parameter. Additionally, Start On and Due On cannot be the same date.
Optional
followers Followers string[]
GIDs of users to add as followers (e.g. 1198765432109876). Followers are a subset of members who have opted in to receive "tasks added" notifications for a project. Use List Users to find available user GIDs.
Optional
htmlNotes HTML Notes string
The notes of the project with formatting as HTML
Optional
owner Owner string
The current owner of the project (a user GID, e.g. 1198765432109876). Use List Users to find available user GIDs.
Optional
defaultAccessLevel Default Access Level string
The default access for users or teams who join or are added as members to the project
Optional
minimumAccessLevelForCustomization Minimum Access Level for Customization string
The minimum access level needed for project members to modify this project's workflow and appearance
Optional
minimumAccessLevelForSharing Minimum Access Level for Sharing string
The minimum access level needed for project members to share the project with others
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-project
Version
1.0.0
App
Asana
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes