Asana Connector

Connect Zenmako to Asana to manage projects, tasks, and team workloads. This enables AI to view project status, create and organize tasks, track assignments, and help keep your team on schedule.

Getting Your Personal Access Token

Asana uses Personal Access Tokens for API authentication. Follow these steps to generate one:

Go to https://app.asana.com/0/developer-console

Click Personal Access Tokens in the left sidebar

Click Create new token

Give your token a descriptive name (e.g., "Zenmako Integration")

Click Create token

Copy the token immediately (it will only be shown once)

Store your token securely. The token has the same permissions as your Asana account, so it can access all workspaces and projects you have access to.

Connecting Asana

Navigate to the Connections page in Zenmako

Click Add Connection and select Asana

Enter your credentials:

- API Token: Paste the Personal Access Token you generated

Click Save

Click Test Connection to verify the setup works

If the test succeeds, your Asana connection is ready to use.

Available Actions

Action

Description

getWorkspaces	Get all accessible Asana workspaces
getProjects	Get all projects in an Asana workspace
getUsers	Get all users in an Asana workspace
getTasksForProject	Get all tasks in an Asana project
getProjectOverview	Get a comprehensive overview of a project including tasks, sections, statistics, and activity
getTaskDetails	Get full task details including description, notes, comments, and subtasks
getUserTasks	Get all open tasks assigned to a specific user in a workspace
createTaskWithSubtasks	Create a task with multiple subtasks in a single operation
moveTaskToSection	Move a task to a different section within a project (can optionally create the section if it does not exist)
completeTaskAndComment	Mark a task as complete and add a completion comment

Example Prompts

Try these prompts to interact with your Asana data:

"Show me all my Asana workspaces and projects"

"What tasks are overdue in the Marketing Campaign project?"

"Get me a summary of the Website Redesign project, including how many tasks are completed"

"What tasks are assigned to Sarah in our main workspace?"

"Create a task called 'Review Q4 budget' with subtasks for 'Gather expense reports', 'Analyze spending', and 'Prepare summary'"

"Move the 'Update landing page' task to the 'In Progress' section"

"Mark the 'Send newsletter' task as complete with the note 'Sent to 5,000 subscribers'"

Common Issues

"Invalid API token" or "Unauthorized" error

This typically means your token is invalid or has been revoked. Solutions:

Verify you copied the complete token without extra spaces

Check that the token has not been deleted in Asana's Developer Console

Generate a new token if needed

Rate limit errors when creating multiple tasks

Asana's free tier has a rate limit of 150 requests per minute. If you are creating tasks with many subtasks, you may hit this limit. Solutions:

Wait a minute and try again

Reduce the number of subtasks per task (the connector limits subtasks to 10 per operation to help avoid this)

Consider upgrading to a paid Asana plan for higher rate limits