ClickUp is used for calendars, timelines, and Gantt charts to plan tasks, to schedule your team, and sync in real-time with Google, Outlook, and Apple. We can use the ClickUp API to import data from ClickUp into Google Sheets. In this tutorial, I’ll show you how to connect the ClickUp API to Google Sheets in 5 steps:
Apipheny is an API connector for Google Sheets. You can use Apipheny to connect your Google Sheets to unlimited API data sources, make unlimited API requests, and more. There is a 30 day free trial included.
1.) Install Apipheny by opening the following link on desktop and then clicking the Install button in the Google Marketplace: https://apipheny.io/install
2.) After you’ve installed Apipheny, open a Google Sheet and then click on the Extensions dropdown in the menu at the top.
In the dropdown list you should see Apipheny. Click Apipheny then click Import API to open the Apipheny sidebar in your Google Sheet.
Tip: you can open a new Google Sheet by entering this URL in your browser: sheet.new
After logging into your ClickUp account, click the drop-down arrow from the bottom-left corner:
In the displayed menu, click the Apps item:
In the API Token section, click the Generate button to display an API token:
Your token is now displayed. Copy it to a safe location, because you’ll need it later:
In this section, we’ll show you how to browse the ClickUp API documentation to find the API URL that retrieves the information you need from your account. If you already know your URL, or you want to use the same example URL as us, just skip to Step 4.
First, open the ClickUp API documentation page: https://clickup.com/api
The menu on the left contains an Introduction section and a Reference section, which includes a list of categories for this API’s endpoints:
For example, if we click the Comments category, the list of endpoints contained by this category will be displayed:
An example endpoint is Get List Comments, which obtains comments for a specific list.
https://api.clickup.com/api/v2/list/list_id/comment
Don’t forget to replace the list_id with a real list id!
The endpoint’s documentation contains its HTTP method (GET), the URI, a list of the accepted parameters, the cURL command and an example response:
All API calls for ClickUp should be made to this base domain: https://api.clickup.com/api/v2/
The Get Task Comments endpoint, which returns the task comments:
Method: GET API URL Path: https://api.clickup.com/api/v2/task/{task_id}/comment Headers: Header 1 Key: Authorization Header 1 Value: your_auth_token
Make sure to replace your_token with the token you previously obtained and the {task_id} with a real value.
The Get Lists endpoint, which allows the user to view the Lists within a Folder:
Method: GET API URL Path: https://api.clickup.com/api/v2/folder/{folder_id}/list Headers: Header 1 Key: Authorization Header 1 Value: your_auth_token
Make sure to replace your_token with the token you previously obtained and the {folder_id} with a real value.
The Get Tasks endpoint, which allows the user to view the tasks in a List:
Method: GET API URL Path: https://api.clickup.com/api/v2/list/{list_id}/task Headers: Header 1 Key: Authorization Header 1 Value: your_auth_token
Make sure to replace your_token with the token you previously obtained and the {list_id} with a real value.
The Get Space Tags endpoint, which allows the user to view the task Tags available in a Space:
Method: GET API URL Path: https://api.clickup.com/api/v2/space/{space_id}/tag Headers: Header 1 Key: Authorization Header 1 Value: your_auth_token Header 2 Key: Content-Type Header 2 Value: application/json
Make sure to replace your_token with the token you previously obtained and the {space_id} with a real value.
The Get Workspace (Everything level) Views endpoint, which allows the user to view the task and page views available at the Everything Level of a Workspace:
Method: GET API URL Path: https://api.clickup.com/api/v2/team/{team_id}/view Headers: Header 1 Key: Authorization Header 1 Value: your_auth_token
Make sure to replace your_token with the token you previously obtained and the {team_id} with a real value.
Now go back to your Google Sheet and make sure that the Apipheny add-on is open on the Import tab. With the Import tab open, enter these details into the add-on:
Method: At the top of the Apipheny sidebar, select the HTTP method (GET or POST) required by your API endpoint. For this example, we are using the GET method.
API URL: In Step 3, we explained how you can find the ClickUp API endpoint that you need. Now copy and paste your complete ClickUp API URL into the Apipheny add-on, where it says API URL Path, followed by any parameters required for your query (if applicable).
For this example, we are using the Get Folders endpoint, which lists the folders from a certain space. This is what the whole URL looks like:
https://api.clickup.com/api/v2/space/space_id/folder?archived=false
If you use this URL, don’t forget to replace space_id with your own space id!
Headers: In the Headers section of Apipheny, add one row with the following key and value:
Key: Authorization Value: your_auth_token
Replace your_ auth_token with the value of the token you generated previously, in Step 2.
Finally, the last step is to click the Run button at the bottom of the Apipheny add-on and then wait for the ClickUp API data to be imported into your Google Sheet. Here’s what our request looked like when completed:
That’s it! You’ve successfully connected your ClickUp account to Google Sheets using the ClickUp API, Google Sheets API, and the Apipheny add-on.
After making a successful request to the ClickUp API, try querying a different ClickUp API endpoint, or try using one of the more advanced features in the Apipheny add-on, such as:
Crypto API Tutorials: