Webhook

The Webhook block lets you trigger a campaign flow from an external system. As soon as a specific event occurs in a third-party application—such as the creation of a lead—that system automatically sends a notification via a URL to Ternair, which then starts the flow.

With the Webhook block, you can create a target audience based on contacts passed from the webhook.


Terms and Conditions
Before you can use the Webhook block, at least one webhook must be configured in the General Settings. For more information on configuring webhooks, please see the link below.
 

Add a Webhook Block

Drag the Webhook block from the category Select recipients From the menu, go to the worksheet; the block opens automatically.


Title
At the top of your screen, you'll see the block's title (default: Webhook). You can customize these.
 

Advanced Mode
In the upper-right corner of your screen, you'll find the "Advanced Mode" toggle.


If you check the ""Advanced Mode" When you check the box, the option to save the target audience block as a template appears. Next to the Save button appear three dots which allows you to open an additional option to save the block as a template.
 

Select Webhook

Select from the dropdown menu Select "Off": Webhook the webhook you want to use.


Tabs
The settings screen of the Webhook block contains the following two tabs:

Tab

Description

Settings

Select the webhook you want to use.

Notifications

Configure who receives a notification email when an error occurs.


Notification
On the Notifications tab, you can specify whether a notification email should be sent when an error occurs in the Webhook block. Under Send notifications to, enter one or more email addresses, and then check Send a notification when an error occurs.

Once checked, a required Subject field appears with default text. You can customize this text. Fields enclosed in square brackets are replaced with the current values when the message is sent. By default, the subject is populated with the relevant selection and block numbers: Error in selection [SelectionId] block [BlockNumber].

The following fields are available: [ExecutionCode], [SelectionId], [BlockNumber], [BlockDescription], [CampaignCode], [User], [IsStart] and [ErrorMessageHtml].


Save / Cancel
The Leads block is saved and calculated after you click the "Save" button. Use the "Cancel" button to undo your changes.
 

Connect Webhook Block
After saving, you can use the Leads block as input for other blocks. Connect blocks by drawing a line from the Leads block to the next channel block.


Open the Webhook block

The first time you drag a Webhook block into the flow, the block opens automatically. To open an existing Webhook block, double-click the block or click the three dots in the upper-right corner in the block.


A context menu appears with the following options:


Option

Description

Run a webhook

Use this button to run the webhook

Save as a template

Click the three dots next to the Save button to save it as a template (Available only when "Advanced Mode" is enabled)

Delete

Remove the block from the flowchart

Cutting

Cut out the block to paste it somewhere else

Copy

Make a copy of the block

Settings

Open the block's settings



Webhook preview (eye icon)

After you save the Webhook block, it will be eye icon blue.


When you click the eye icon, a preview of the selected target audience appears.


The preview displays the following information:

Number of rows
The number of contacts in the target group.


Target Audience Data
Information about the selected contacts, such as their email addresses.


View more data
Click the button “View more data” to open a detailed overview with additional information about the target audience.
 

Refresh Data
Click on the refresh-icon to refresh the data (for example, after recent changes).


Close Window
Close the preview by clicking the little cross Click in the upper-right corner or use the Close button.


Webhook URL (triangle icon)

Click on the triangle icon to copy the URL that is called from the webhook. The Webhook block allows you to trigger a campaign flow in Ternair based on events from an external system. For example, when a lead is created in that system, it automatically sends a notification via the URL to Ternair, which then immediately activates the flow.



The pop-up displays the following information:

Webhook Name
The name of the selected webhook


URL
The URL being called is displayed under the webhook's name. You can open this URL, select it, and easily copy it.


Copy
Next to the URL is an icon you can click to copy the entire URL at once.


Close Window
Close the pop-up by clicking on the little cross Click in the upper-right corner.


Frequently asked questions

  • What is the difference between a webhook audience and the Webhook block?

    Both options can be found in the Campaign Manager under Choose Recipients. The webhook audience is an option within the Audience block. When you enable Advanced Mode, you can select a webhook instead of a standard audience. The audience is then populated using data returned by that webhook. The Webhook block, on the other hand, is a separate block that allows an external system to start your campaign flow via a URL, for example when a new lead is created. Within this block, you can execute the webhook and copy the generated URL. To use the Webhook block, a webhook must first be configured in the General Settings.

  • When should you choose the Audience block and when the Webhook block?

    Choose the Webhook block when an event in an external system should immediately start your campaign. As soon as the external system calls the URL of the Webhook block, for example when a lead is created, the campaign flow is executed.

    Choose the Webhook Audience when you want to process contacts received through a webhook in the Audience Manager first and send the campaign at a scheduled time. To do this, create a selection in the Audience Manager using a Webhook block, link it to an audience, and make that audience available for campaigns. In the Campaign Manager, select this audience using the webhook option in the Audience block with Advanced mode enabled. Connect the Audience block to a channel block, such as an email block, and then connect it to a Schedule block. Calling the webhook does not start the campaign in this setup. A typical example is a daily email sent at a fixed time to the contacts most recently provided by the external system. The audience contains only the contacts from the latest webhook call.


Copyright © 2026 Ternair.