Skip to main content
POST
/
v1
/
table
/
{table_uuid}
/
add-waterfall
curl --request POST \
  --url https://api.databar.ai/v1/table/{table_uuid}/add-waterfall \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <x-apikey>' \
  --data '
{
  "waterfall": "email_getter",
  "enrichments": [
    833,
    966
  ],
  "mapping": {
    "first_name": "first_name",
    "last_name": "last_name",
    "company": "company"
  },
  "email_verifier": 10
}
'
{
  "id": 42,
  "waterfall_name": "Email finder waterfall"
}

Headers

​
x-apikey
string
required

API Key for authentication

Path Parameters

​
table_uuid
string<uuid>
required

The UUID of the table

Body

application/json
​
waterfall
string
required

Waterfall identifier (e.g. 'email_getter'). Get from GET /v1/waterfalls.

​
enrichments
integer[]
required

List of enrichment (provider) IDs to use in the waterfall cascade. Get available IDs from GET /v1/waterfalls/{identifier}.

Minimum array length: 1
​
mapping
Mapping · object
required

Maps waterfall parameter names to table column identifiers (UUID) or column names (the key used in GET /v1/table/{uuid}/rows response). Get column identifiers from GET /v1/table/{uuid}/columns.

​
email_verifier
integer | null

Optional enrichment ID for email verification (only for email waterfalls).

Response

Waterfall added successfully

​
id
integer
required
​
waterfall_name
string
required