Getting started
In this guide we'll walk through setting up an integration with Quickbooks Online using Building Blocked.
- A GitHub or Google account to sign in
- A JavaScript or TypeScript app to integrate with Building Blocked (this could be Node.js, Cloudflare Workers, or any JavaScript runtime you prefer)
To get started, login at app.buildingblocked.com with GitHub or Google to create an account. This will create a Personal Organization for you automatically.
From the organization Projects page, select New Project. You'll be asked a few questions about your project, like what to call it and what to call your first API key. Once you're done, you'll be presented with an API key to use with Building Blocked. Save this value in your app's secrets. Don't worry, you can generate more API keys later if you need.
Now the fun part 😃 Let's write some code that uses Building Blocked.
First, we'll install the Building Blocked SDK from npm. This will give make working with the APIs easier and provide types.
Next, we'll initialize the Building Blocked SDK with our API key. This is frequently stored as an environment variable.
After following the OAuth 2.0 flow for Quickbooks Online, you'll receive an OAuth access token for accessing Quickbooks APIs on behalf of the user. We can exchange this access token for a Building Blocked access token.
Once you have a Building Blocked access token, you can interact with the API platform. The token knows the details for interacting with the Quickbooks API. Not only that, tokens for other integrations work the same way! The data returned by listCustomers is normalized across all integrations.
- Try the Building Blocked demo app
- Measure API usage
- Upgrade your plan
- Create more projects