hotglue will automatically create two starter flows when you get started: Invoices and Sales
You can customize these flows by changing the supported sources and target. Each starter flow has 2 default data sources, and 1 target. Alternatively, you can create your own flow by pressing the New Flow button on the flow dashboard.
Each flow has a set of supported sources – these are a list of what data sources your users can connect to your product. Although starter flows come with preconfigured supported sources for development, you should customize the supported sources to the ones you want.
We'll enable the Quickbooks source as an example. Feel free to follow along with any other supported source
The first step is to configure an OAuth application for the source you wish to use. This process depends on the tap - for this example, we'll show you how to configure Quickbooks. Keep the client ID and client secret handy for this process.
Let's start by enabling the Quickbooks source. In the flow wizard, find Quickbooks and press Connect.
When you press the source you want, it will prompt you with the configuration options. For Quickbooks, it asks for the OAuth credentials (client ID and client secret):
Once you've copied your OAuth credentials in, press save, then connect! You'll be redirected to log in, and then Quickbooks will appear as a supported source.
Now we can proceed with configuring the field map.
hotglue enables developers to select the relevant data from each supported source, rather than parsing large JSON payloads or finding the relevant API endpoints. To start, we select the field mapping icon for the Quickbooks source we've just connected.
This will show the field map wizard. For this example, I'll search for the Invoice object from Quickbooks
Once you select your desired objects, you can select the fields you wish to capture:
Once finished, select Confirm on the Field Editor, then Save on the Object Selector – you've completed configuring the Quickbooks source.
To ingest processed data from hotglue in your backend, you must configure a target in the hotglue admin panel.
The first step is to obtain any necessary credentials for the target you wish to use. This process depends on the target - for this example, we'll show you how to configure AWS S3. Keep the IAM credentials handy for this process.
Once you've added your supported source, let's configure where you want the data to go. For this example, we'll output to S3
Press add target in the flow wizard
Press connect on the target you'd like, and provide the credentials.
Note: for more information on configuring the S3 target, go to the S3 target documentation
Once you're done, press connect, and voilà - your first flow is ready!
By default, hotglue will take the output data from these sources and convert it into a CSV. For this quick start guide we'll keep it simple, but if you'd like to write more complex preprocessing scripts visit the transformations section and check out our samples on GitHub.
Now that all of that is set up we can run our first job for this source! There are many ways to do this but for our example we'll run a manual sync job.
To learn how to set schedule jobs or run them using the hotglue API, jump to the Jobs section.