Clay Icon
Join the Community
02 Support

Understanding the Waterfall Method in API Call Management

Avatar of Romeo M.Romeo M.
·
·

Explain a bit how the waterfall works, especially this part here with the output. Provide a path from this action’s JSON payload to be used in the waterfall. My use case is that I’m doing three different API calls. I get different kinds of data from each API call, and I want to make sure that you’re handling the waterfall correctly - I’m getting one, then the other, then the other. I don’t understand the reason. What do we mean by this payload? It’s true that from one API call I can send data to the other API call. I really don’t get it. Now I have three HTTPs, and I’m not able to save it. I know that I could do groups and rules that if you have data in one, they move to the other. But can you explain to me a little bit what’s the difference between a group and just rules vs. this waterfall?

2 comments

  • Avatar of Channeled
    Channeled
    APP
    ·
    ·

    Waterfalls in Clay are an intelligent way to get only the data you need on a row-by-row basis from multiple providers. They work by sequentially querying providers until the required data is found, ensuring efficiency and cost savings. For API calls, waterfalls automate the process of running multiple actions sequentially. Each provider in the waterfall is queried in order, and Clay stops further enrichments once valid data is found. This process eliminates the need for manual uploads and lookups across different providers. Custom waterfalls allow you to choose any integration combinations and search for any data point depending on the integrations you use. This flexibility enables you to configure the sequence of data providers and specify the required inputs for searching. The main difference between waterfalls and groups/rules is that waterfalls are specifically designed for efficient data enrichment across multiple providers, while groups and rules are more general-purpose workflow tools in Clay. If you need more detailed information about JSON payloads or API specifics, please provide the relevant JSON or API call details so I can assist you further.

  • Avatar of Channeled
    Channeled
    APP
    ·
    ·