How to connect the ClickUp API to Google Sheets

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:

  1. Install the Apipheny add-on
  2. Obtain a personal token
  3. Choose a ClickUp endpoint
  4. Enter your ClickUp API request into Apipheny
  5. Run the ClickUp API request in your Google Sheet

Step 1.) Install and open the Apipheny add-on in Google Sheets

To pull data from the ClickUp API to Google Sheets, first install and open the Apipheny Google Sheets add-on.

Apipheny is a no-code API integrator for Google Sheets that you can use to make unlimited API requests, connect to unlimited APIs, save API requests, schedule API requests, and more. 

1. Install Apipheny by opening the following link on desktop and then clicking the Install button on the page: https://apipheny.io/install.

Install Apipheny in the Google Workspace Marketplace
Install Apipheny in the Google Workspace Marketplace

2. After you’ve installed Apipheny, open a Google Sheet and then click on the Add-Ons or Extensions option in the top menu. In the add-ons menu, you should see Apipheny.

Click Apipheny > Import API to open the Apipheny sidebar in your Google Sheets.

Opening the Apipheny add-on in Google Sheets
Opening the Apipheny add-on in Google Sheets

Step 2.) Obtain a personal token

After logging into your ClickUp account, click the drop-down arrow from the bottom-left corner:

ClickUp account
ClickUp account

In the displayed menu, click the Apps item:

ClickUp menu
ClickUp menu

In the API Token section, click the Generate button to display an API token:

API Token section
API Token section

Your token is now displayed. Copy it to a safe location, because you’ll need it later:

Generated token display
Generated token display

Step 3.) Choose a ClickUp Endpoint

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:

ClickUp documentation
ClickUp documentation

For example, if we click the Comments category, the list of endpoints contained by this category will be displayed:

Endpoints categories
Endpoints categories


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:

Endpoint documentation
Endpoint documentation

All API calls for ClickUp should be made to the https://api.clickup.com/api/v2/ base domain.

Step 4.) Enter your ClickUp API request into Apipheny

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

Don’t forget to replace the space_id with your space id!

Headers: In the Headers section of Apipheny, add one row with the following key and value:

Key:
Authorization
Value:
your_auth_token

your_ auth_token value is the value of the token generated previously, in Step 2.

ClickUp API request entered into Apipheny
ClickUp API request entered into Apipheny

Step 5.) Run the ClickUp API request in your Google Sheet

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:

ClickUp data imported into Google Sheets
ClickUp data imported into Google Sheets

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:

  • Save and schedule your ClickUp API request
  • Make a POST request to the ClickUp API (if available)
  • Use the custom =APIPHENY() function to call the ClickUp API request inside your spreadsheet
  • Create an API request by referencing the value of a cell in your ClickUp API URL with three curly braces eg. {{{Sheet1!A1}}}

Related articles:

Related Posts