Webhook Import

Webhook Import

Import data that was sent to Parabola in a Webhook, or via an API POST to Parabola.

Trigger your Parabola flow to run, and use the data from the triggering event

The Webhook Import is in beta, and is not available to use by everyone at this time. If you are interested in using this step, and the overall webhook feature, contact us!

The Webhook Import is a unique source in Parabola. It works in tandem with the Webhook feature, which allows your flows to run when triggered by an event from another system. This import, will bring the data from that triggering event into your flow. Webhooks are a common feature in many of your favorite tools, so setting up this step will require working with another tool at the same time.

The unique part of this import is that it cannot import data whenever it wants, like all other imports can. It can only import data when data is sent to it.

What is a Webhook?

Webhooks are how tools can let each other know that events have occurred. Let's say that you have an online store, every time that a purchase is made, you could send a webhook from your payment processor to your email tool to send an email confirmation of the purchase. That webhook would be sent with information such as the customer, the items purchased, and the amount charged.

Generally, it is expected that once a tool receives a webhook, it will then process the data included with the webhook as needed.

How Webhook data can be used in your flow

The Webhook Import is the way for you to pull data from a webhook that your flow received and work with it. Every time your flow receives a webhook, the flow will begin running, and if you are using this Webhook Import, then data will be imported.

In our example about the online shop, the purchase order would send a webhook to your Parabola flow, which would now have information such as the customer, the amount spent, and the items.

What happens when multiple webhooks are received by your flow

If your flow is running while another webhook comes in, or many other webhooks come in, those hooks will be queued up to run one after another. Parabola flows do not run in parallel, so each incoming webhook will need to wait in line to be processed.

Our expectation is no webhooks are dropped and all are successfully queued and processed. If you send a very large amount of webhooks to a flow at the same time, you may hit some limits.

How to set up the Webhook Import in your flow

The current version of the Webhook Import does not have a way to get data from a webhook into your builder. This make it generally difficult to build with this step because you do not have any data to see how your transformations are actually changing your data.

There are two ways to get data into this step:

  1. Mock out your data and build with that
  2. Catch a real webhook from your published flow, and then build with that

To mock out data, enter valid JSON into the mock data field in the Webhook Import and click Update Settings.

To catch a real webhook from your published version, do as follows:

  1. Add the Webhook Import step to your flow
  2. Add a CSV Export to your flow
  3. Publish your flow
  4. On the right side of your flow, click on the webhooks tab
  5. Copy the webhook URL and add it to your service that will be sending webhooks to your Parabola flow
  6. Trigger an event in the other service that will send a webhook to your Parabola flow
  7. Check your flow, open the Webhook Import, and verify that there is new data in the Webhook Import from your webhook service
  8. Click the Draft button in the toggle at the top of the flow to create a draft from the published flow that contains the webhook data
  9. Now, your Webhook Import has data! You can begin building with it.

Technical details about webhooks

A webhook is an API request to a URL. Each Parabola flow has a URL that can be sent an API request by another tool to start your flow with some pieces of data.

For example, a webhook may look like this:

POST https://parabola.io/api/hook/9asdhf2983h289fh
{"id":"1234","amount":"50.00","customer":"Sara Johnston"}

When your flow is sent that request, it will start your flow. The Webhook Import will have one row of data, with three columns, called id, amount, and customer. The values of those columns would be 1234, 50.00, and Sara Johnston.

If the request has any query parameters added to that Parabola webhook URL, they will also be included in the table of data imported.

Every Webhook Import will catch every hook that comes into your flow URL. So it is very difficult to have multiple services sending webhook data to the same flow. One flow per webhook source is best.

Start automating with Parabola

Parabola is free to use for teams of any size. We also offer paid plans with additional features and support.