Search API Connector Documentation
Import Asana Data to Google Sheets
In this guide, we’ll walk through how to pull tasks from the Asana API directly into Google Sheets, using the API Connector add-on for Sheets.
There are 2 ways to connect to the Asana API:
- Preset “Connect” button (OAuth) premium
- Personal access token. Please check the appendix for detailed instructions to retrieve your token.
- Before You Begin
- Part 1: Connect to the Asana API
- Part 2: Pull Data from Asana to Sheets
- Part 3: Create a Custom Request
- Part 4: More Example API URLs
- Part 5: Handle Pagination
- Part 6: API Documentation
- Appendix: Connect with an Asana Personal Access Token
Before You Begin
Click here to install the API Connector add-on from the Google Marketplace.
Part 1: Connect to the Asana API
The easiest way to get started with the Asana API is through API Connector’s built-in integration.
- Select Asana from the drop-down list of applications
- Under Authorization, click Connect to Asana
- You be asked to authorize the connection. Click Allow.
- You’ll then be returned to your Google Sheet, and can verify that your Asana connection is now active.
Part 2: Pull Data from Asana to Sheets
Now that we’re connected, let’s pull some data into Sheets.
- Under Endpoint, choose Get your workspaces. This will return your workspace ID(s), which you’ll need for subsequent requests.
- There are no other required parameters for this endpoint, so just select a destination sheet, name your request, and click Run. You’ll see your workspace ID returned in the data.gid field.
- You can now plug this value into other requests. For example, the /projects endpoint can accept a workspace ID as a filter.
Part 3: Create a Custom Request
Alternatively, you can create a custom request instead of using API Connector’s built-in integration, using any of the URLs shown in the API documentation. To create a custom request, add the complete URL into the request URL field and select Asana from the OAuth menu.
To easily convert from a preset request to a custom API URL, tick the Add request URL box before running your preset request (under Output options). This will print out your complete API URL, which you can then copy/paste into the request URL field.
Part 4: More Example API URLs
Here are some more examples of custom API URLs. Check the documentation for the full list of possible requests.
- Retrieve all your tasks
PROJECT_IDwith your project ID (run a request to the
/projectsendpoint or click on your project and check the URL bar to see this value).
- Create a new task
As noted earlier, find your
PROJECT_IDvalue from the URL bar in the interface, and get your
WORKSPACE_IDfrom your initial
https://app.asana.com/api/1.0/users/merequest. Input your task details into the POST body as described in the documentation, like this:
You will immediately see your new task reflected in your Asana dashboard. Note that you can only create one task at a time with this method.
Part 5: Handle Pagination
Asana recommends using pagination when retrieving large result sets, to break responses into smaller sets. If your response set is too large, you may receive an error like this: “The result is too large. You should use pagination (may require specifying a workspace)!” To resolve this issue, paginate your response by using the ‘limit’ and ‘offset’ parameters as described in the documentation.
In API Connector, you can cycle through these paginated requests automatically using pagination handling (paid feature), like this:
- Pagination type:
next page URL
- Next page path:
- Run until: choose when the request should stop running
Part 6: API Documentation
Official API documentation: https://developers.asana.com/docs
Appendix: Connect with an Asana Personal Access Token
This method is a free alternative to the method described above. Instead of clicking Connect, retrieve your own personal token.
- Log in to Asana and click your profile icon in the top right corner to open the profile drop-down menu. Click ‘My Profile Settings’
- From the My Profile Settings menu, click Apps
- Click Manage Developer Apps
- On the Developer Apps screen, click “+New Access Token”
- A screen will open, prompting you to provide a name. You can name it whatever you like, but here we’ll name it Google Sheets. Check the terms and conditions box, and click Create Token.
- You’ll now see your Token. Congrats! Copy it to your clipboard.
- To use this token, under Headers, enter Authorization as your Key, and Bearer YOUR_TOKEN as your Value, like this:
- Your requests should run as described in the Custom requests section. Just make sure to select OAuth = None as you’re connecting with a token instead.