Team
Shared credential for production and unattended runs.
Connect Asana with Hookshot™ and your stack
Tool to help teams organize, track, and manage their work.
Use cases
Popular ways to use Asana
Examples of orchestrating work when Asana is wired through Hookshot™.
- Create or triage tasks from forms, CRM updates, or inbound webhooks
- Sync escalations from support tools into Asana with assignees, sections, and due dates
- Summarize Slack or email threads into task descriptions, comments, or subtasks
- Update tasks when CI finishes, releases ship, or checks fail in your dev stack
- Review overdue work—reschedule, delegate, or close completed items in bulk
- Mirror milestones from spreadsheets or databases into projects and timelines
- Attach meeting outcomes and decisions as structured comments on the right tasks
- Alert owners when portfolios, goals, or projects stall against deadlines
- Route inbound requests across workspaces using tags, sections, and custom fields
- Spin up onboarding or launch projects from templates with tasks for each stage
Tools and triggers
What Agents can do in Asana
Available tools and events after Asana is connected.
-
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 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 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…
-
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 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…
-
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 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 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 Task Comment
Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.
-
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 Team
Tool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.
-
Delete a Project
Delete a project.
-
Delete a Section
Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.
-
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.
-
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 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 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.
-
Duplicate Project
Duplicate a project.
-
Duplicate Task
Duplicate a task
-
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 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 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 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 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 Project Templates
Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.
-
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 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…
-
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…
-
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 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 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 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 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…
-
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 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.
-
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…
-
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 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 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 Users for Team
Get users in a team.
-
Get Users in Workspace
Get users in a workspace or organization.
-
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.
-
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.
-
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…
-
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.
-
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…
-
Retrieve Tasks for Project
Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.
-
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 a Project
Update a project.
-
Update a Task
Updates attributes of an existing Asana task identified by its task_gid.
-
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 a Webhook
Tool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.
-
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 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 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…
-
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…
-
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 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.
-
Attachment Added to Task
Triggers when an attachment is added to a task.
-
New Comment on Task
Triggers when a comment is added to a task in a project.
-
New Task Created
Triggers when a new task is created in a project.
-
Tag Added to Task
Triggers when a tag is added to a task. Note: Asana's event structure is inverted for tag events — the resource is the task and the parent is the tag. So parent.gid gives the tag GID.
-
Task Moved to Section
Triggers when a task is moved to a section in a project.
-
Task Updated
Triggers when a task is updated in a project.
Setup
Connect Asana in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
