Skip to main content

Provider Triggers

Provider Triggers are reusable webhook subscriptions you can use to trigger your flow by a specific event of virtually any Provider as long as it offers API connectivity.

Superflow comes pre-stacked with a wide variety of Providers and Provider Triggers however, you can add your own Custom Provider and Custom Provider Trigger with ease. You can define which webhook you want to subscribe to, Input Fields, Conditions and the expected return values.


Add a Custom Provider Trigger

warning

Adding Custom Provider Triggers is only supported for Providers that support webhook registration via API!

danger

Some Providers limit the number of webhooks you can subscribe to, often depending on your plan with the Provider. The total number of Trigger iterations for a Provider might be limited by this amount.

  1. Navigate to the Flow Builders Triggers tab and scroll down to Provider Triggers.
  2. Click + Add Trigger underneath the Provider you want to add your Trigger to.

Add a Custom Trigger

Basic Information

  • Display Name: Enter the name of the Trigger (e.g., "User subscribed"). Note that special characters are prohibited.
  • Short Name: Enter the name of the Trigger shown in the left sidebar (e.g., "Subscribed").
  • Description (optional): Provide a brief description, such as "When someone subscribes to newsletter".
  • Subcategory: Select a subcategory that best fits the Trigger’s functionality. You can create your own subcategory by clicking +.

Queries

Provide queries for Register and Unregister according to the Provider's specifications.

Register

  • Method: Choose the required method. This is usually POST.
  • Path: The path your webhook registration request will be sent to. Refer to the Provider's documentation for further information.
  • Body: Specify the webhook registration request according to the Provider's requirements. Refer to the Provider's documentation for further information.
info

When setting up the registration request, the Callback URL provided by Superflow is required. You can simply insert it using Insert Callback URL Variable in either the path or the body, depending on the Provider's requirements.

Unregister

  • Method: Choose the required method. This is usually DELETE.
  • Path: The path your webhook unregister request will be sent to. Refer to the Provider's documentation for further information.
  • Body: Specify the webhook unregister request according to the Provider's requirements. This might remain empty, if the webhook id is provided via the path. Refer to the Provider's documentation for further information.
info

When setting up the unregistration request, the Webhook ID specified by the Provider is required. See Webhook ID Path and ensure Webhook ID is specified. You can simply insert it using Insert Webhook ID Variable in either the path or the body, depending on the Provider's requirements.

Use of Variables

You can use Provider Parameters and Variables (drag & drop) within your schema as well as Input Variables from your Input Fields (Insert Variable in input list).

Modifying Variables with Modifiers

When working with Provider Variables or Input Variables you can take advantage of Modifiers.

Input Fields

Some Providers allow for filtering which data you subscribe to or even let you set conditions that need to be met for the webhook to be updated. To make dynamic use of these capabilities, equip your Trigger with Input Fields.

The following example shows a webhook registration request for SendGrid. Note how the Input Variables are implemented into the request to make the Trigger customizable using its Input Fields.

Use Input Fields

Registration Test

  1. Select the Provider connection you want to register the webhook at or create a new one.
  2. Click Test Register Webhook.

Once the webhook registration is completed, details about the webhook subscription will be shown below in the tabs Body, Headers and Request. Any errors the Provider might report will be shown here as well. Refer to the Provider's documentation for further information.

Webhook ID Path

In order to successfully unregister the webhook Superflow needs to identify your webhook's id specified by the Provider. In the request body look for id or something similar. Enter the path and key. This usually simply is id.

Webhook Response

As soon as you successfully registered the webhook subscription, Superflow will start "listening", waiting for the webhook to respond.

Perform an action at the Provider that will trigger the webhook.

Once triggered you will see the webhook's response.

Unregistration Test

In order for your Trigger to work properly, it must be able to unregister the webhook. Make sure Unregister and Webhook ID Path is set up correctly and click Test Unregister Webhook. Any errors the Provider might report will be shown in the body. Unregistering a webhook successfully usually returns an empty body.

Save & Publish

Once all configurations are complete and both Register and Unregister were tested successfuly, click Save to finalize your Trigger.

warning

Note that if you changed settings of an existing Trigger, you need to republish your Apps for them to take effect.