Asana

153 tools available · 6 triggers

Tool to help teams organize, track, and manage their work.

Connect Asana to Definable to turn discussions into tasks, roll up daily progress, reprioritise the roadmap on impact. Personas call Asana's 153 tools (and react to 6 triggers) directly from chat or scheduled flows. Pair with a delivery persona — the agent keeps the tracker in lock-step with what the team is actually doing.

Common workflows with Asana

Slack → tasks

Listen for action-item phrasing
Agent creates a structured task
Assigns and dates it automatically

Daily standup digest

Pull yesterday's task changes
Summarise per assignee
Post to the team channel

Roadmap re-prio

Read open issues + recent customer feedback
Persona scores by impact
Suggests new ordering for review

Asana actions 153

Every Asana action below is a callable tool any Definable persona can invoke.

Add Followers to Project

Tool to add followers to a project in Asana. Use this tool when you need to add one or more users as followers to a specific project. Followers will receive notifications when tasks are added to the project.

Add Followers to Task

Tool to add followers to a task in Asana. Use this tool when you need to add one or more users as followers to a specific task. This will notify them of updates to the task.

Add item to portfolio

Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint. Use when a workflow needs to attach a newly created project to a portfolio without using ASANA_SUBMIT_PARALLEL_REQUESTS.

Add Members to Project

Tool to add users to a project in Asana. Use this tool when you need to add one or more users as members to a specific project. Members can view and contribute to the project.

Add Project to Task

Tool to add a project to a task in Asana. Use when you need to associate a task with a project. Optionally position the task within the project using insert_before, insert_after, or section parameters.

Add Supporting Relationship to Goal

Tool to add a supporting goal relationship to a goal. Use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in Asana.

Add Tag to Task

Tool to add an existing tag to a task in Asana. Use when you need to add a tag for prioritization, routing, or automation workflows. Tags cannot be added via Update Task, so this dedicated endpoint is required.

Add Task Dependencies

Tool to add dependency relationships to an Asana task. Use when you need to mark one or more tasks as prerequisites (dependencies) for another task, ensuring the dependency tasks must be completed first.

Add task to section

Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.

Add User for Team

Tool to add a user to a team in Asana. Use this when you need to add a user to a specific team by providing their user GID, email, or "me" for the current user.

Add User for Workspace

Tool to add a user to a workspace or organization in Asana. Use this when you need to add a user to a specific workspace by providing their user GID, email, or "me" for the current user.

Approve Access Request

Tool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.

Create Access Request

Tool to create an access request in Asana. Use when you need to request access to a project or portfolio that you don't currently have access to.

Create Allocation

Creates a new allocation. Use when you need to schedule or assign a specific amount of a user's time per week to a task or project within a defined period.

Create a project

Creates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.

Create a tag in a workspace

Creates a new tag, with properties like name and color defined in the request body, within a specific Asana workspace (using `workspace_gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.

Create task in asana with specific details

Creates a new Asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.

Create Attachment for Object

Tool to upload an attachment or link an external resource to a task, project, or project_brief in Asana. Use when you need to attach a file or external URL to any Asana object.

Create Attachment for Task

Tool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.

Create Custom Field

Tool to create a new custom field in a workspace. Use when you need to define a new field for tracking specific information within Asana tasks.

Create Enum Option for Custom Field

Tool to create a new enum option for a custom field in Asana. Use this when you need to add a new selectable option to an existing custom field.

Create Membership

Tool to create a membership by adding a user or team to a project, goal, or portfolio. Use when you need to grant access to an Asana resource.

Create Project Brief

Tool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.

Create project for team

Tool to create a project in a team. Use when you need to create a new project within a specific Asana team.

Create project for workspace

Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace. Note: The team field is required when creating projects in workspaces.

Create Project Status Update

Tool to create a new status update on a project. Use when you need to communicate the current status, progress, or any blockers related to a specific project.

Create a section in a project

Creates a new SECTION (not a task) in a project. Sections are organizational containers within a project used to group and categorize tasks (e.g., 'To Do', 'In Progress', 'Done', 'Backlog'). The new section can be optionally positioned relative to an existing section in the same project. IMPORTANT: This action creates SECTIONS only. Do NOT use this action to create tasks. To create a task, use the ASANA_CREATE_A_TASK action instead. Task-related fields like 'assignee', 'notes', 'due_date', 'description' are NOT supported by this action.

Create Status Update for Object

Tool to create a status update on a project, portfolio, or goal. Use when you need to communicate progress, blockers, or current state to all followers of an object.

Create subtask

Creates a new Asana subtask under an existing parent task (`task_gid`); `due_on` and `due_at` are mutually exclusive and cannot be set simultaneously.

Create a tag

Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks. Tags help organize and filter tasks across projects but are not automatically applied to any tasks.

Create task comment

Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.

Create Team

Tool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.

Delete Allocation

Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.

Delete Attachment

Tool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.

Delete Custom Field

Tool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.

Delete Membership

Tool to delete a membership by its GID. Use this when you need to remove a user or team's access to a project, portfolio, goal, or custom field in Asana.

Delete a project

Delete a project.

Delete Project Brief

Tool to delete a project brief by its GID. Use when you need to remove a project brief from Asana. Note: This requires the project_brief_gid (not the project_gid).

Delete Project Status

Tool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.

Delete a section

Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.

Delete Status Update

Tool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.

Delete Story

Tool to delete a story by its GID. Use when you need to remove a story from Asana.

Delete a Tag

Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.

Delete a task

Delete a task.

Duplicate Project

Duplicate a project.

Duplicate Task

Duplicate a task

Get Access Requests

Tool to retrieve access requests for a target object. Use when you need to get pending access requests for a specific resource like a project or portfolio.

Get Allocation

Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.

Get Allocations

Tool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.

Get a project

Retrieves a specific Asana project by its `project_gid`, with an option to include additional fields for comprehensive details using `opt_fields`; this action does not return tasks within the project.

Get a task

Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.

Get Attachment

Tool to get a single attachment by its globally unique identifier. Use when you need to retrieve details about a specific file attached to a task or project.

Get Audit Log Events

Tool to get audit log events for a workspace. Use when you need to retrieve a log of actions performed within a specific Asana workspace.

Get a user task list

Retrieves a specific user's task list from Asana by its `user_task_list_gid`, optionally returning extended details like name, owner, and workspace if specified in `opt_fields`.

Get current user

Retrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.

Get Custom Field

Tool to get a single custom field by its globally unique identifier. Use when you need to retrieve the complete metadata and properties of a specific custom field in Asana.

Get Custom Fields for Workspace

Tool to get all custom fields in a workspace. Use when you need to retrieve a list of custom fields associated with a specific workspace.

Get Custom Types

Tool to get all custom types associated with a project. Use when you need to retrieve custom types that extend Asana objects for categorization purposes.

Get Events on a Resource

Retrieve events on a resource to monitor changes. Use when you need to track activity or changes related to a specific Asana resource like a task, project, or tag.

Get Favorites for User

Tool to get a user's favorites within a specified workspace. Returns favorites ordered as they appear in the user's Asana sidebar.

Get Goal

Retrieve the full record for a single goal by its GID.

Get Goal Relationships

Tool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.

Get Goals

Tool to retrieve multiple goals. Requires exactly one scope parameter (workspace, team, portfolio, or project) to be specified. Can be optionally filtered by time period or archived status.

Get Job

Tool to retrieve a job by its globally unique identifier. Use when you need to check the status of asynchronous operations like task duplication, project instantiation, or exports.

Get Membership

Tool to retrieve a single membership by its ID. Use this when you need to get details about a specific membership relationship between a user/team and a goal, project, portfolio, or custom field.

Get Memberships

Tool to retrieve memberships for goals, projects, portfolios, or custom fields. Use this to find out who has access to a specific Asana resource or what resources a specific user/team has access to.

Get multiple projects

Returns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.

Get multiple tasks

Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`; `workspace` also requires `assignee`.

Get multiple users

Returns a list of users in an Asana workspace or organization, optionally filtered by workspace or team GID, with support for pagination and specifying optional fields.

Get multiple workspaces

Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.

Get Portfolio

Retrieve the full record for a single portfolio by its GID. Use this when you need to get detailed information about a specific portfolio.

Get Portfolio Items

Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.

Get Portfolio Memberships

Tool to retrieve multiple portfolio memberships. Use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.

Get Portfolios

Retrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.

Get Project Brief

Tool to retrieve a project brief by its GID. Use when you need to get the detailed explanation (what and why) of a project. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

Get Project Membership

Tool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.

Get Project Memberships For Project

Tool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.

Get Projects for Task

Tool to get all projects a task is in. Use when you need to retrieve project associations for a specific task.

Get Projects for Team

Tool to get a list of projects for a specific team in Asana. Use when you need to retrieve project details associated with a team.

Get Project Status

Tool to retrieve the full record for a single project status by its GID. Use when you need to get the details of a specific project status update.

Get Project Status Updates

Tool to get status updates for a specific project. Use when you need to retrieve the latest or historical status reports associated with an Asana project.

Get Multiple Project Templates

Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.

Get Project Templates for Team

Tool to get a team's project templates in Asana. Use when you need to retrieve project templates associated with a specific team.

Get Reactions on Object

Tool to get reactions with a specific emoji base character on an object. Use when you need to retrieve user reactions (emoji responses) on a status update or story.

Get Section

Retrieve the full record for a single section by its GID. Use this when you need to get details about a specific section within a project.

Get sections in a project

Returns compact records for all sections (used to group tasks) in a specified project.

Get Status Update

Tool to retrieve the full record for a single status update by its GID. Use when you need to get the details of a specific status update.

Get Status Updates

Retrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.

Get Stories for Task

Tool to get stories (comments, status updates, etc.) for a task. Use when you need to retrieve the history or discussion associated with a specific task.

Get Story

Tool to retrieve a story. Use when you need to get the complete record for a single story.

Get Tag

Tool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.

Get Tags

Get multiple tags in a workspace.

Get Tags for Task

Tool to get all tags associated with a specific task. Use when you need to retrieve tags for categorization, filtering, or understanding task organization.

Get Tags For Workspace

Tool to get all tags in a specific workspace. Use when you need to retrieve tags for categorizing tasks within a workspace.

Get Task Attachments

Tool to get the list of attachments for a given task, project, or project_brief. Use when you need to retrieve files attached to a specific Asana object.

Get Task Counts For Project

Tool to get task count statistics for a project. Use when you need to retrieve the number of tasks, completed tasks, incomplete tasks, and milestone counts for a specific Asana project. Note that all fields are excluded by default - you must specify them in opt_fields to get any data.

Get tasks for tag

Tool to retrieve tasks associated with a specific Asana tag by tag GID. Use when you need to list all tasks that have been tagged with a particular label.

Get tasks for user task list

Tool to retrieve tasks from a user task list by user task list GID. Use when you need to list tasks assigned to a specific user's task list.

Retrieve tasks for project

Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.

Get tasks from a section

Tool to retrieve tasks that belong to a specific Asana section (column/header) by section GID. Use when you need to list tasks within a particular section, such as for agenda or carryover workflows. Board view only feature.

Get Task Subtasks

Tool to retrieve multiple task subtasks from a workspace. Use when you need to list or find available task subtasks.

Get Task Templates

Tool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.

Get Team

Tool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.

Get Team Membership

Tool to retrieve a complete team membership record by its GID. Use when you need to fetch details about a specific team membership in Asana.

Get Team Memberships

Tool to retrieve compact team membership records. Use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.

Get Team Memberships for Team

Tool to get memberships from a specific team. Use when you need to retrieve the list of users who are members of a particular team, including their membership details such as admin status and guest status.

Get Team Memberships For User

Tool to get team memberships for a specific user. Use when you need to retrieve all teams that a user belongs to within a workspace.

Get Teams for User

Tool to get teams for a specific user in an organization. Returns the team records for all teams in the organization or workspace to which the given user is assigned.

Get teams in workspace

Returns the compact records for all teams in the workspace visible to the authorized user.

Get Time Period

Tool to retrieve the full record for a single time period by its GID. Use when you need to fetch detailed information about a specific time period, including its start/end dates, display name, and parent period.

Get Time Periods

Tool to retrieve compact or full representations of time periods. Use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.

Get Time Tracking Entries

Tool to get multiple time tracking entries across workspace, tasks, or projects. Use when you need to retrieve time tracking information for filtering by workspace, task, portfolio, user, or date range.

Get Time Tracking Entries for Task

Tool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.

Get Objects via Typeahead

Tool to retrieve objects in a workspace via a typeahead search algorithm. Use when you need to quickly find objects like tasks, projects, users, etc., based on a search string. This is useful for implementing auto-completion features.

Get User

Get a user by their ID.

Get User in Workspace

Tool to get a user in a workspace or organization by their GID. Use when you need to retrieve details about a specific user within a workspace context.

Get Users for Team

Get users in a team.

Get Users in Workspace

Get users in a workspace or organization.

Get User Task List

Tool to get a single user task list by its globally unique identifier. Use when you need to retrieve information about a specific user's My Tasks list.

Get Webhooks

Tool to retrieve multiple webhooks in a workspace. Use when you need to list all webhooks for a workspace or filter webhooks by a specific resource.

Get Workspace

Tool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.

Get Workspace Membership

Tool to retrieve a specific workspace membership by its GID. Use when you need to get details about a user's membership in a workspace.

Get Workspace Memberships

Tool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.

Get Workspace Memberships For User

Tool to retrieve workspace memberships for a specific user. Use when you need to list all workspaces a user is a member of.

Get Workspace Projects

Tool to retrieve the projects associated with a specific workspace. Use when you need to list all projects within a given Asana workspace.

Reorder Enum Option for Custom Field

Tool to reorder an existing enum option within a custom field by moving it before or after another specified enum option. Use when you need to change the order/position of options in an enum or multi_enum custom field. Note: To create new enum options, use 'Create Enum Option for Custom Field' action instead.

Move or Insert Section in Project

Tool to move or reorder an existing section within a project by repositioning it before or after another section. Use when you need to change the position/order of sections in a project. Note: This action moves existing sections only. To create new sections, use 'Create Section in Project' action instead.

Instantiate Project Template

Instantiate (create) a real Asana project from a project template, returning the async job record. Use when you need to create a new project from a template with specific date and role assignments.

Reject access request

Tool to reject an access request. Use when you need to deny a user's request for access to a project or resource.

Remove Follower From Task

Tool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.

Remove Followers For Project

Tool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.

Remove Item from Portfolio

Tool to remove an item (e.g., a project) from an Asana portfolio. Use to undo/cleanup portfolio membership, support moves between portfolios, or enforce portfolio hygiene.

Remove Members from Project

Tool to remove users from a project in Asana. Use this tool when you need to remove one or more users as members from a specific project.

Remove Project from Task

Tool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.

Remove Tag from Task

Tool to remove an existing tag from a task in Asana. Use this tool when you need to detach a tag from a specific task for cleanup or retagging automation.

Remove User For Team

Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.

Remove User from Workspace

Tool to remove a user from a workspace or organization. Use when you need to revoke a user's access to a specific workspace.

Search Tasks in Workspace

Tool to search tasks across a workspace with advanced filters. Use when performing complex queries such as overdue tasks, by project or custom field, for reporting or automation.

Set parent for task

Tool to set the parent of a task in Asana. Use when you need to make a task a subtask of another task or remove the parent relationship.

Submit Parallel Requests (Batch API)

Tool to submit multiple Asana API requests in parallel using the Batch API. Use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.

Update Allocation

Tool to update an existing allocation by its ID. Use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.

Update a task

Updates attributes of an existing Asana task identified by its task_gid.

Update Custom Field

Tool to update a custom field by its globally unique identifier. Use when you need to modify properties of an existing custom field in Asana.

Update Enum Option

Tool to update an enum option for a custom field. Use when you need to modify the name, color, or enabled status of an existing enum option.

Update a project

Update a project.

Update Project Brief

Tool to update a project brief by its GID. Use when you need to modify the content/description of a project brief. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

Update Section

Update a section's name or position within a project. Use when you need to rename a section or reorder sections by specifying insert_before or insert_after.

Update Story

Tool to update a story on a task. Use when you need to modify the text, html_text, or pin status of an existing story. Only comment stories can have text/html_text updated, and only comment and attachment stories can be pinned.

Update Tag

Tool to update an existing tag by its globally unique identifier. Use when you need to change the name or color of a tag.

Update a team

Tool to update details of an existing team. Use when you need to change a team's name, description, or organization.

Update User

Update a user's custom fields. Note: Asana's API has very limited user update capabilities - most user properties are read-only and managed by users themselves.

Update User for Workspace

Tool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.

Update a webhook

Tool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.

Frequently asked questions

What can I automate with Asana on Definable?

Anything Asana exposes through its API. Common project management workflows on Definable include turn discussions into tasks, roll up daily progress, reprioritise the roadmap on impact. Personas can call any of the 153 Asana tools directly, or react to its 6 triggers, then chain the result into another integration without you writing code.

How does Asana authentication work?

Asana uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Asana integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 153 Asana tools. You only need a separate Asana subscription if Asana itself charges per seat or per API call.

Is using Asana through Definable secure?

Every call from a persona to Asana is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Asana on Definable?

Sign up for Definable, open the integrations page, find Asana, and connect via OAuth or API key. You can immediately attach Asana to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Asana actions does Definable expose?

Definable exposes all 153 Asana actions as callable tools — including `Add Followers to Project`, `Add Followers to Task`, `Add item to portfolio`, plus 150 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Asana?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations