Receive from webhook
The Receive from webhook step receives data that was sent to Parabola in an external service's Webhook feature. It is an import step that brings in data triggered by an event that took place on the external service, such as a customer purchasing an item on a platform like Shopify. The step is currently in beta and you may gain access to it by reaching out to email@example.com.
Connect your external service's account
First, set up an example flow with one import step (Receive from webhook) and one export step of your choosing.
Then, select the button "Run Flow" or "Update Live Version" to save your flow. Once it saves, the page will automatically direct you from the Editor mode to the Dashboard mode.
In the Dashboard mode, select the button "Run Flow Now →" to run it.
After that, a Run History section should appear with a log showing a blue Webhook icon to the right of it.
To the left of this Run History log, under Flow Settings, select "Configure webhooks" to open a pop-up window with the URL link. Highlight and copy this link to give to your external service in their webhooks section. Be sure to not return to the Editor mode. If you have, select the button "Discard Drafts" and return to the Dashboard mode.
After you've copied the Webhook link and entered it into your external tool's webhooks area, do a test initiation event to trigger this webhook (or wait for one to happen naturally).
Then, return to your flow that should have auto-ran from this event on the external service (like a customer purchasing an item). Select the Editor mode to open up your flow's builder again.
The flow will now have the test webhook data pulled into it. Double-click on the Receive from webhook step to view it. This way, you'll get an idea of what the service's hook data looks like when its received and you can build out a flow that deals with it in the way you'd like. Please note that you must wait for a webhook to run at least once in order to go back to the flow's editor mode and see displayed hook data — otherwise, the step's display will be blank.
- What is a Webhook?: Webhooks are how tools communicate to one another when an event happens. For example, if you have an online store and someone makes a purchase, a webhook could be sent from your payment system to your email tool confirming the purchase. The webhook would send information like the customer, items purchased, date, and amount charged.
- How Webhook data can be used in your flow: this step enables you to pull data in from a webhook that your flow can work with. Every time your flow receives a webhook, the flow will begin running and processing that incoming event-triggered dataset.
- What happens when multiple webhooks are received by your flow: If your flow is processing a dataset while another webhook with a dataset (or multiple) comes in, then they will queue up to be pulled into your flow in the order they were received. All webhooks sent to a flow, even if multiple at a time, will be queued up and processed.
- Step refresh button?: The refresh button doesn't exist in this step since the data pulled in is triggered by an event happening on an external service and is sent over by webhook. In order for your flow to catch the hook data and pull it in, after you set up your sample flow and select "Update Live Version" to be redirect to the Dashboard page, don't return to the editor by selecting Editor mode until you see in the Flow History run log a blue webhook button next to an entry. Only after you see a blue webhook associated run log should you then select the Editor button and return to the builder. This is because if you clicked on the Editor button, you created a newer flow draft version that isn't finalized or published to catch the webhook data. Though the older flow version may run and appear in 'Flow History' run logs, you won't be able to view the data in the Editor mode since selecting that button overwrote the previous draft file the webhook sent to.
- Limitations: If you send a very large amount of webhooks to one flow at the same time, you may hit some limits in the amount of datasets that can be received and processed. This step cannot pull in data from a source whenever you'd like and instead can only pull in data when data is sent to it through an event-based action.