Quaderno is a tool for automatically calculating sales tax in different jurisdictions. In this guide, we’ll walk through how to pull data from the Quaderno API directly into Google Sheets, using the API Connector add-on for Sheets. We'll first get an API key from Quaderno, and then set up a request to pull in invoice data to your spreadsheet.

• Part 1: Get your Quaderno API Key
• Part 2: Create your API Request URL
• Part 3: Enter values into API Connector
• Part 4: Notes and Expansions

PART 1: GET YOUR QUADERNO API KEY

1. While logged into your Quaderno account, click your Profile icon > API keys from the header bar.
   
2. Copy down your Private Key. That is the only value we need here.
   
3. One last step: Because the Quaderno API requires Basic Authentication, we need to encode our authentication info to base 64. You can do this by entering your your credentials in the format {Private key}:x into this form (i.e. your private API key, then a colon, and then an 'x'). Your encoded credentials will appear underneath.

   The encoding script runs in your browser, and none of your credentials are seen or stored by this site.

   Base64 Encode

   (If you have any problems with the above, please check this post for some alternate methods of encoding your credentials).

PART 2: CREATE YOUR QUADERNO API REQUEST URL

We’ll follow the documentation to access a list of invoices.

• API root: https://YOURSITE.quadernoapp.com/api
• Endpoint: /invoices.json

Putting it together, we get the full API Request URL:

 https://YOURSITE.quadernoapp.com/api/invoices.json

(Of course, you need to enter in your own subdomain)

PART 3: ENTER YOUR VALUES INTO API CONNECTOR

We can now enter our values into API Connector and import Quaderno API data into Google Sheets.

1. Open up Google Sheets and click Add-ons > API Connector > Create New API Request.
2. In the Create Request interface, enter the Request URL we just created
   

3. Under Headers, enter Authorization as your Key, and Basic {base64-encoded string} as the value:
   

   Authorization

   Basic {base64-encoded string}

   Replace {base64-encoded string} with the base64-encoded string you created in part 1.
   

4. Create a new tab. You can call it whatever you like, but here we'll call it 'Invoices'. While still in that tab, click 'Set' to use that tab as your data destination.
5. Name your request. Again we'll call it 'Invoices'
6. Click Run and a moment later you’ll see a list of your Quaderno invoices in your Google Sheet:
   

PART 4: QUADERNO API + SHEETS NOTES

You can check the documentation for the full list of available API requests,  but if you just want to jump in, you can play around with the URLs you enter in the API URL path field. Try the following (one at a time), substituting in actual values in the spots marked by curly brackets:

1. https://YOURSITE.quadernoapp.com/api/contacts.json
https://YOURSITE.quadernoapp.com/api/receipts.json
https://YOURSITE.quadernoapp.com/api/credits.json
https://YOURSITE.quadernoapp.com/api/expenses.json
https://YOURSITE.quadernoapp.com/api/expenses.json
https://YOURSITE.quadernoapp.com/api/estimates.json
https://YOURSITE.quadernoapp.com/api/recurring.json
https://YOURSITE.quadernoapp.com/api/items.json
https://YOURSITE.quadernoapp.com/api/payments.json
2. Note that Quaderno limits the number of records returned in each request. By default, only 25 records will be returned unless you use the 'limit' and 'page' parameters as described in their documentation.
   

   To access more than 25 records, add the 'limit' and 'page' parameters like this:

   page 1: https://YOURSITE.quadernoapp.com/api/contacts.json?limit=100&page=1

   page 2: https://YOURSITE.quadernoapp.com/api/contacts.json?limit=100&page=2

   With API Connector, you can either set these up as separate requests or loop through them automatically with pagination (paid feature) for added efficiency, like this:
   

IMPORTANT SECURITY NOTE

Anyone with Owner or Edit access to your Google Sheet can view all the information you've saved within API Connector, including API keys and other credentials. Treat these keys as passwords and limit access to your sheet accordingly.