How to connect the Clubhouse API to Google Sheets

Clubhouse is a social networking app based on audio-chat. We can use the Clubhouse API to import data from Clubhouse into Google Sheets. In this tutorial, I’ll show you how to connect the Clubhouse REST API to Google Sheets in 5 steps:

  1. Install the Apipheny add-on
  2. Obtain an API token
  3. Choose a Clubhouse endpoint
  4. Enter your Clubhouse API request into Apipheny
  5. Run the Clubhouse API request

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

To pull data from the Clubhouse 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 an API token

After logging into your Clubhouse account, click the user icon from the bottom-left corner, then in the displayed menu click the Settings option:

Clubhouse account Dashboard
Clubhouse account Dashboard

Click the API Tokens option from the menu on the left:

Clubhouse Settings section
Clubhouse Settings section

In the API Tokens section, type a name in the Token Name field, then click the Generate Token button:

Clubhouse API Tokens section
Clubhouse API Tokens section


Your token is now generated. Copy it to a safe location because you’ll need it in the next steps:

Clubhouse Generated Token
Clubhouse Generated Token

Step 3.) Choose a Clubhouse Endpoint

In this section, we’ll show you how to browse the Clubhouse 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 Clubhouse API documentation page: https://clubhouse.io/api/rest/v3/

The menu on the left contains an Introduction section and a list of categories, each with its own endpoints:

Clubhouse API endpoints documentation
Clubhouse API endpoints documentation

For example, if we click the Entity-Templates category, a list with its endpoints will be displayed: 

Entity-Templates category content
Entity-Templates category content

An example endpoint is List Entity Templates which lists all the entity templates for an organization:

https://api.clubhouse.io/api/v3/entity-templates

The endpoint’s documentation contains a short description of its purpose, the HTTP method (eg. GET), its URI, an example request as a cURL command and its associated example response:

List Entity Templates endpoint documentation
List Entity Templates endpoint documentation

All API calls for Clubhouse should be made to the https://api.clubhouse.io/api/v3/ base domain.

Step 4.) Enter your Clubhouse 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 Clubhouse API endpoint that you need. Now copy and paste your complete Clubhouse 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 List Categories endpoint which returns a list of all categories and their attributes. This is what the whole URL looks like:

https://api.clubhouse.io/api/v3/categories

Headers: In the Headers section of Apipheny, add two rows with the following key and value:

Header 1
Key:
Clubhouse-Token
Value:
<your_token>
Header 2
Key:
Content-Type
Value:
application/json

<your_ token> value is the string you generated previously, in Step 2. Do not include the brackets around your token when you enter is into the headers.

Clubhouse API request entered into Apipheny
Clubhouse API request entered into Apipheny

Step 5.) Run the Clubhouse 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 Clubhouse API data to be imported into your Google Sheet. Here’s what our request looked like when completed:

Clubhouse data imported into Google Sheets
Clubhouse data imported into Google Sheets

That’s it! You’ve successfully connected your Clubhouse account to Google Sheets using the Clubhouse API, Google Sheets API, and the Apipheny add-on.

After making a successful request to the Clubhouse API, try querying a different Clubhouse API endpoint, or try using one of the more advanced features in the Apipheny add-on, such as:

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

Related articles:

Related Posts