Select Data Model in the sidebar, under Configuration. Then select the
Waterfalls tab.Admin access is required.
How a waterfall runs
Default runs a waterfall 1 of 2 ways, depending on where it runs:Credits
Default bills enrichment in credits, per provider:- Every provider that returns data is billed, even when higher providers already filled all of its fields. In the Enrich Data node and in pre-enrichment, that can be several providers per record.
- A provider that charges for a lookup with no match is billed for that miss too. Of the waterfall providers, Clearbit charges for a miss. Apollo, People Data Labs, and Wiza are billed only when they return data.
- When Default calls providers 1 at a time, it stops at the first provider with data, so the providers after it are not called or billed.
Waterfalls list
The Waterfalls page opens with a Primary Waterfall banner and a card grid of all your waterfalls.Primary waterfall
The Primary Waterfall banner at the top of the page lets you set 1 waterfall as the workspace default. Workflows use the primary waterfall when they do not reference a specific waterfall. Select a waterfall from the Primary Waterfall dropdown to set it. Each card in the grid shows the waterfall’s provider icons, name, and the maximum number of enrichment credits it can consume per call. This maximum is the sum of all providers’ per-call costs, for the case where every provider is billed. A Primary badge marks the current primary waterfall.Search
Use the Search Waterfalls bar to filter cards by name or description.Create a waterfall
Select New Waterfall to open the Create new Waterfall dialog.1
Name and describe the waterfall
Enter a Name for the waterfall, for example
Email Finder. Add an optional
Description to explain its purpose, such as
Tries Apollo then Clearbit to find a verified work email.2
Add and order providers
Under Enrichment order, select Add Provider to open the provider picker. You can
add up to 5 providers per waterfall.The available enrichment providers are:
Each provider row shows its position number and the credit cost per call.Drag the handle on any row to change the order. The provider at position 1 has the highest
priority.To remove a provider, hover the row. Select the trash icon.
3
Turn on validation (optional)
The Validation section runs optional checks alongside pre-enrichment. Each check shows
its credit cost per call.
- Email validation: turn on the switch to validate email addresses. Then choose a provider, Abstract Email Reputation or Icypeas.
- IP validation: turn on the switch to validate visitor IP addresses.
4
Verify provider fields (optional)
Once you select at least 1 provider, an alert offers to View the enrichment fields
the current provider set can return. Select View to open the provider fields panel.Confirm the waterfall covers the fields you need before you save. Select Back to
return to the form.
5
Save
Select Create Waterfall. The new waterfall appears in the card grid.
Edit a waterfall
Hover a waterfall card and select the pencil icon. This opens the card’s context menu. Choose Edit. The Edit Waterfall dialog is identical to the creation dialog.
Set a waterfall as primary
To change which waterfall is primary, do one of the following:- Use the Primary Waterfall dropdown in the banner at the top of the page.
- Open a waterfall card’s context menu and select Make Primary.
Delete a waterfall
Open a waterfall card’s context menu. Select Delete. A confirmation dialog appears with the waterfall’s name. Confirm to permanently remove it. You cannot undo deletion.Before deleting a waterfall, check whether any workflow Enrich Data nodes reference it.
Those nodes stop resolving a waterfall after deletion.