API

The Asana API is a RESTful interface, allowing you to programmatically update and access much of your data on the platform. It provides predictable URLs for accessing resources, and uses built-in HTTP features to receive commands and return responses. This makes it easy to communicate with from a wide variety of environments, from command-line utilities to browser plugins to native applications.

Learn more about the Asana API on the Asana Developers Site.

Asana Connect

Asana Connect is an easy and secure way to grant API access to third-party applications without sharing your username and password.

Asana Connect uses OAuth 2.0, an industry standard for authentication. You have likely used OAuth to authenticate and log in to services using your Facebook, Twitter, or Google accounts.

Always use discretion when approving access to your account. Carefully read any access or permission requests from the services to which you are connecting. It is also recommended that you regularly review apps you have authorized and revoke access from integrations you no longer want or need to have access to your account; you can always grant access again later.

To review your account’s authorized applications:

  1. Click your profile photo from the top bar and select My Profile SettingsProfile Settings Profile Settings lets users adjust preferences related to their specific account. Read more
  2. Navigate to the Apps tab
  3. Review the Authorized section

You can revoke an app’s access at any time from this tab using the Deauthorize button next to that app’s name.

Manage Developer Apps

If you’re a developer, use the Developer App Management page to create Personal Access Tokens and access your API Key.

To access the Developer App Management page:

  1. Click your profile photo from the top bar and select *My Profile SettingsProfile Settings Profile Settings lets users adjust preferences related to their specific account. Read more
  2. Navigate to the Apps tab
  3. Click Manage Developer Apps

From the Developer App Management page, you can:

  1. Manage or register apps that you own
  2. Manage or create new Personal Access Tokens
  3. View your API Key

Personal Access Tokens

Personal Access Tokens provide individuals with a low friction means to access the Asana API when writing scripts, working with command line utilities, or prototyping applications. In most cases you should not provide personal access tokens to applications you do not know or fully trust the creator of.

Creating a Personal Access Token

  • Click your profile photo from the topbar
  • Select My Profile Settings…
  • Open the Apps tab
  • Click Manage Developer Apps
  • Click + Create New Personal Access Token

Create a Personal Access token from the Developers App Management page:

  1. Type a description of what you’ll use the Personal Access Token for
  2. Click Create
  3. Copy your token and use it to authorize requests

Read more about working with authentication in the Asana API in our developer documentation.

Applications that support accessing Asana on behalf of many users should make use of Asana Connect rather than Personal Access Tokens.

It’s good practice to regularly review and deauthorize access tokens you no longer want or need.

API Key (Deprecated)

The API Key is being phased out and will eventually not be supported for use with the Asana platform.

If you are an Asana user looking for your API Key so that you can provide it to an application, you may not be able to use that application until the developer updates it to use one of Asana’s alternative forms of authentication. Asana cannot give you access to the application—you must contact its developer.

If you are a developer, you should switch your application to use OAuth instead. For more information, you can learn more about the API Key deprecation and solutions for your application here.

Log in

or

Forgot password?

Sign Up

Please use your work email address, so we can connect you with your team in Asana.

Sign Up

Please use your work email address, so we can connect you with your team in Asana.

Start a trial

Please login or sign up for Asana to begin your Premium trial.

or

Forgot password?

Buy Now

Please use your work email address, so we can connect you with your team in Asana.

Enter a work email address

This email looks like a personal email address. If you want to be connected with your team, please use your work email address.

Enter a work email address

Why are we asking? Continue with my email

Oops, we couldn’t sign you up!

We tried, but there was a problem creating your account. Please close this window and try again!

Hey there, we’ve already met!

Add link to

Error: Please select a workspace before adding link


Sorry, we don’t support this browser

Asana doesn’t work with the internet browser you are currently using. Please sign up using one of these supported browsers instead.


Please login or sign up for Asana to calculate your price

or

Forgot password?

Asana Lessons

Learn the Asana basics in less than 15 minutes with these quick lessons

Tasks

Tasks Lessons

Track all of your work

3 Minutes

My Tasks

My Tasks Lessons

Always know what to do next

3 Minutes

Projects

Projects Lessons

Work with teammates

3 Minutes

Inbox

Inbox Lessons

Communicate even faster

3 Minutes

You can use tasks to track, collaborate on, and organize all your work.

Tasks can be to-dos, ideas, notes, or reminders.

Assign a task to yourself or a teammate.

Press Tab+M to quickly assign a task to yourself.

Add a due date so your deadline is clear.

Add instructions and expectations in the task description field.

Type @ to link to other tasks, people, conversations, or projects.

When you @mention someone, they’ll be added to your task as a follower.

Followers get notified when new comments or attachments are added.

Add anyone who needs to stay up to date on your task as a follower.

They can always unfollow to stop getting notifications on your task.

Add comments to ask questions or give followers updates.

Heart a comment to let followers know you’ve seen it.

Add relevant files or irrelevant GIFs as attachments.

You can also attach directly from Dropbox, Google Drive, or Box.

Create subtasks to break your task into smaller steps.

When you’ve added a subtask, press enter to add another.

Subtasks can contain all the same details as regular tasks.

Click the comment bubble to add comments or attachments to a subtask.

You can create tasks from any screen using your top bar.

Every Task has a unique URL to easily copy and share.

Congrats! Looks like you’re up to the task.

On to the next lesson!

Always know what to do next with My Tasks.

My Tasks is a list of every task assigned to you.

It makes managing your work simple.

Click on your My Tasks list and start typing to add tasks.

Like a text document, add a new line for each new task or paste in any list.

Forward to x@mail.asana.com to turn your emails into tasks

Asana will translate your email into a task, including your attachments.

New tasks will appear at the top of your list in New Tasks.

Tasks you add to My Tasks are private to you.

Click Make Public to share them with your team.

Prioritize tasks as Today, Upcoming, or Later.

Click on the blue dot next to the task, to quickly sort it.

Mark the tasks you’ll have time for Today.

Teammates can view your My Tasks list to see what you’re up to.

They’ll only see tasks you’ve made public or shared in a project (more on projects later).

Mark tasks due within a week as Upcoming so you can see what will be due soon.

On its due date, your task will move from Upcoming to Today.

Just like magic.

Mark tasks due in more than a week for Later.

They’ll be out of your way until their due date approaches.

Your tasks will move from Later to Upcoming a week before they’re due.

Keep My Tasks prioritized to always know what to work on and what’s coming next.

Now you know how to track and plan your work!

Next, learn how to work with your team in Asana.

Work together on groups of tasks with projects.

Projects help you track and organize the steps in a process or initiative.

Like an event plan, product launch, or editorial calendar.

Like My Tasks, simply click and type to add tasks to your project.

If you have your steps in a document or email already, paste in that list.

Add tasks to your project from email.

View your project’s unique email address from the project dropdown menu.

Add your tasks to other related projects.

Tasks can be included in multiple projects.

Add sections to organize tasks in a list project.

Type : at the end of any task title to make it a section.

Or, add columns to organize tasks in a boards project.

Drag and drop tasks between or within columns to reorder.

Assign your tasks and set due dates.

Never miss a deadline with your project calendar.

Drag and drop tasks on your calendar to change their due dates.

Add everyone who needs to stay updated on your project as members.

Project members will get notified of new conversations, statuses, and tasks.

Post conversations to make announcements or start discussions.

Your post will be sent to all project members.

Use Progress to see how your project is moving forward.

Set a project status to update your team on how it’s going.

The Project Owner will be reminded to set a status once a week.

Open and organize projects from your sidebar.

Favorite projects to pin them to the top of your sidebar.

Click the star button on the left of your project name to favorite it.

Create new projects from any screen using your top bar.

Now you can move projects forward with your team.

Just one more lesson before you dive in.

Communicate and coordinate faster with Inbox.

Check Inbox to quickly read and respond to your latest updates.

Inbox will notify you when you have a task due…

and when teammates update tasks, conversations, and projects you follow.

Open and respond to updates without leaving Inbox.

Click an update and you’ll have all the context you need to respond.

Archive updates you’re ready to dismiss.

Click the X that appears on the right of an update to archive it.

Open Archive to move dismissed updates back to your Inbox.

Click the arrow that appears on the right of an archived update to move it back to Inbox.

Unfollow tasks or projects to stop receiving updates about them.

In the end, you have control over the updates you receive (or choose not to receive)

When you’re ready, you can turn Asana’s Email notifications off.

Most communication with your team can be more easily managed from Inbox. Just remember to check it often.

Congratulations! Now you’re ready to have a great work day with Asana.