Guides

Getting Started

• API explorer — Learn to use the helpful tools embedded in our API Reference
• Changelog
• Developer sandbox — Learn how to request a developer sandbox
• FAQ — Frequently asked questions about the Asana platform
• Postman Collection
• Quick start guide — Get started with the API and make your first request

Authentication and OAuth

• Authentication
• OAuth
• OAuth scopes
• OpenID Connect
• Personal access token
• OAuth Code Samples / Libraries

Client Libraries

• Client libraries
• Java
• JavaScript
• PHP
• Python
• Ruby
• Migration guide: v3 — Migrating from v1 to v3 of the Node.js library
• Migration guide: v5 — Migrating from v3 to v5 of the Python library

Platform Concepts

• Audit log events
• Custom fields
• Dates and times
• Deprecations
• Errors
• Graph exports
• Input/output options — Using opt fields to customize API responses
• Rate limits
• Rich text
• SCIM
• Using bots

Webhooks

• Webhooks

App Components

• App component approval checklist — A list of criteria your app component app must meet to pass our review process
• App components — Learn about Asana's extensible UI platform called app components
• App components on rules
• App components on tasks
• Building app components
• UI builder

Script Actions

• FAQ
• How to write a Script Action script
• Script action examples — This section provides example scenarios that can be solved using script actions
• Script Actions

Publishing Your App

• App listing guidelines
• Manage your app
• Publish your app
• Share your app

MCP Server

• Compatible MCP Clients
• Integrating with Asana's MCP Server — This guide walks you through connecting your MCP client to the official Asana MCP server. You'll create an OAuth app in the Asana develop...
• MCP Server
• MCP Tools Reference
• Using Asana's MCP Server
• Connecting Coding Clients to Asana's V2 server