Skip to main content

Asana

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Asana account to Nirvai to manage tasks, projects, and team workflows programmatically.

Supported Authentication Methods​

  • Personal Access Token (PAT) - Recommended for personal/single-user integrations

Prerequisites​

  • An Asana account (free or paid)
  • Workspace access for the projects you want to manage

Setup Instructions​

  1. Log in to your Asana account
  2. Go to Developer Console
  3. Click Create new token under "Personal Access Tokens"
  4. Enter a description (e.g., "Nirvai Integration")
  5. Click Create token
  6. Important: Copy the token immediately - it won't be shown again
  7. In Nirvai, create a new Asana credential and paste the token

Token Permissions​

Personal Access Tokens have the same permissions as your Asana account:

  • If you're a workspace admin, the token has admin access
  • If you're a member, the token has member-level access
  • Access is limited to workspaces you're part of

Token Management​

Viewing Active Tokens​

  1. Go to Developer Console
  2. View all your active tokens under "Personal Access Tokens"

Revoking Tokens​

  1. Go to Developer Console
  2. Find the token you want to revoke
  3. Click the trash icon to delete it

Troubleshooting​

Common Issues​

  • 401 Unauthorized: Token may be revoked or invalid. Generate a new token.
  • 403 Forbidden: You don't have access to the resource. Check workspace/project permissions.
  • 404 Not Found: The task/project may not exist or you don't have access.
  • Rate limited: Asana has rate limits. Implement backoff strategies for bulk operations.

API Rate Limits​

Asana uses the following rate limits:

  • Standard: ~1500 requests per minute
  • Responses include X-Asana-Request-Count header
  • Implement exponential backoff when hitting limits

Best Practices​

  • Use separate tokens for different applications
  • Revoke tokens you no longer need
  • Never share tokens or commit them to version control
  • Use the principle of least privilege (consider creating a dedicated Asana user for automation)

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.