Ready to get started?

Learn more about CData Cloud Hub or sign up for a free trial:

Learn More

Query FreshBooks Data as a MySQL Database in Node.js

Execute MySQL queries against FreshBooks data from Node.js.

You can use the CData Cloud Hub to query FreshBooks data through a MySQL interface. Follow the procedure below to create a virtual database for FreshBooks in the Cloud Hub and start querying using Node.js.

The CData Cloud Hub provides a pure MySQL, cloud-to-cloud interface for FreshBooks, allowing you to easily query live FreshBooks data in Node.js — without replicating the data to a natively supported database. As you query data in Node.js, the CData Cloud Hub pushes all supported SQL operations (filters, JOINs, etc) directly to FreshBooks, leveraging server-side processing to quickly return FreshBooks data.

Create a Virtual MySQL Database for FreshBooks Data

You can use any MySQL client to connect to the CData Cloud Hub and create virtual databases.

  1. Connect to the CData Cloud Hub:
    mysql --host --user admin --password
  2. Once authenticated, create the virtual database for FreshBooks:
    mysql> CREATE DATABASE freshbooksdb
        -> DRIVER = "FreshBooks",
        -> DBURL = "CompanyName=CData;Token=token;";

With the virtual database created, you are ready to connect to FreshBooks data from any MySQL client.

Query FreshBooks from Node.js

The following example shows how to define a connection and execute queries to FreshBooks with the MySQL module. You will need the following information:

  • Host name, or address, and port: The address of your instance of the Cloud Hub ( and the port (3306)
  • Username and password: The username and password of a user you authorized on the Cloud Hub
  • Database name: The database you configured for FreshBooks (freshbooksdb)

Connect to FreshBooks data and start executing queries with the code below:

var mysql      = require('mysql');
var fs         = require('fs');
var connection = mysql.createConnection({
  host     : '',
  database : 'freshbooksdb',
  port	   : '3306',
  user     : 'admin',
  password : 'password',
  ssl      : {
    ca : fs.readFileSync('C:/certs/myCA.pem')
connection.query('SELECT * FROM Clients', function(err, rows, fields) {
  if (err) throw err;