Customize flows

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.

hotglue automatically configures each starter flow to email the output data to you via Mailgun

default hotglue flows

Add a supported source

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

hotglue – choose supported sources

Create the OAuth App

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.

Enable the source

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.

Configure 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.

Add a target

To ingest processed data from hotglue in your backend, you must configure a target in the hotglue admin panel.

hotglue – choose target

Create the credentials

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.

Enable the target

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!

Next steps

Customize the transform script

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.

Run a job

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.