Introducing the Goals API

Hello all! Our team is committed to deliver a feature-rich API, and today we’re excited to announce new API endpoints available for Goals!

With Goals, you can drive alignment across your company by consolidating goals and tying them directly to your teams’ work. We’re introducing this functionality in the API, so you can now build custom integrations to programmatically:

  • Get a holistic view of your organization’s goals in a single place
  • Automate large amounts of work and progress updates
  • Make changes to goals in your tools of choice

Now, on to the good stuff! Here’s what we’ve added:

Head over to our docs to see how it all works!

As always, feel free to leave comments and questions here. Be sure to check back for more updates and announcements as well as we continue to add new features to the API. Happy goal-achieving! :rocket:


Great news, already using that API! Keep it coming :heart:


A quick update today: we’ve exposed endpoints for Time Periods and for creating a Goal through the API. The table in the original post has been updated as well. Happy Friday, everyone!


Is it working now? I´m trying to use all the methods associate with goals and i´ve been receiving this:

“Client’ object has no attribute 'goals”. Shoud I use a different endpoint? I´m trying to do this request with Python using the examples on Asana API page.


Hi @AndrewWong

I have a question, I try to access the goals ( but I get this error message:

{“errors”:[{“message”:“You should specify one of portfolio, project, workspace, team”,“help”:“For more information on API status codes and how to handle them, read the docs on errors: Asana”}]}

I have the workspace ID however I don’t know how to add in the URL, could you please help me?

Thank you very much!


Hi @M_Àngels_Jover,

Here is the syntax for that:

cc: @AndrewWong
Andrew, the example for this endpoint in the API docs isn’t right; it doesn’t show the use of a qualifier like workspace, portfolio, etc. so IMO it makes sense that users like this would be confused.

Hey @Bruno_Zamberlan ,
In case you’re still looking for a solution, I have one for you:
You need to connect the goals resource to the asana client object:

Once done, you should be able to use all the functions described in:

Good luck :slight_smile:

1 Like

Thanks! I collect the latest version on the GitHub and installed it. Now It´s been available to me!