Maintenance & troubleshooting

Maintaining your app

Be sure that the email address associated with your custom app is being actively monitored. We use this email address to notify developers about critical issues (e.g., if your app gets banned from the API, major deprecations affecting your app, etc.).

If you are using a PAT to authenticate, you should confirm that the email address associated with the Asana account that generated the PAT is being actively monitored by one or more people.

👍

Join the Asana developer community

We also recommend all developers join the Asana developer forum. This is where we will communicate new API features as well as announce upcoming breaking changes and deprecations.

To ensure you don’t miss these announcements, we encourage you to turn on notifications for the Platform News section of the community.

Troubleshooting issues

If your app is having issues, follow these best practices to help you troubleshoot:

  • Carefully read any error messages (see error codes for more details).
  • Check if an Asana API deprecation or breaking change is causing the issue.
  • Check the status of Asana’s services to confirm they’re running and not potentially causing your issues.
  • Check the developer forum to see if others are having the same issue. It could be an API bug.
  • If you can't find an answer in the community, post your issue and someone will likely help. Please include all of the required information to reproduce the issue (e.g. cURL request with full response). Never post a PAT to the forum (or share it anywhere else).
  • Email Asana support: api-support at asana.com