Waterfall

Waterfall integration (Data, Marketing). Imported from open-connector.

API key7 toolshttps://api.waterfall.io

POST

waterfall_verify_email

Verify one email address with Waterfall and return deliverability status.

/v1/verify/email

1 parameter

Param	Type	Required	Description
email	string	required	Email address to verify.

POST

waterfall_launch_contact_enrichment

Launch a Waterfall contact enrichment job and return the job envelope.

/v1/enrichment/contact

9 parameters

Param	Type	Required	Description
email	string	optional	Professional or personal email address to enrich.
linkedin	string	optional	LinkedIn profile URL or slug for the contact.
full_name	string	optional	Full name of the contact.
first_name	string	optional	First name of the contact.
last_name	string	optional	Last name of the contact.
domain	string	optional	Company domain used with the contact name.
include_phones	boolean	optional	Whether Waterfall should also run phone enrichment.
webhook_url	string	optional	Webhook URL that Waterfall should call when the job completes.
custom_fields	object	optional	Custom metadata to echo back in Waterfall finder responses.

GET

waterfall_get_contact_enrichment

Retrieve Waterfall contact enrichment job state and output by job ID.

/v1/enrichment/contact

1 parameter

Param	Type	Required	Description
job_id	string	required	The Waterfall job ID returned by a launcher action.

POST

waterfall_launch_company_enrichment

Launch a Waterfall company enrichment job and return the job envelope.

/v1/enrichment/company

5 parameters

Param	Type	Required	Description
domain	string	optional	Company domain or full URL to enrich.
linkedin	string	optional	Company LinkedIn URL or slug to enrich.
name	string	optional	Company name to enrich when domain or LinkedIn is not available.
webhook_url	string	optional	Webhook URL that Waterfall should call when the job completes.
custom_fields	object	optional	Custom metadata to echo back in Waterfall finder responses.

GET

waterfall_get_company_enrichment

Retrieve Waterfall company enrichment job state and output by job ID.

/v1/enrichment/company

1 parameter

Param	Type	Required	Description
job_id	string	required	The Waterfall job ID returned by a launcher action.

POST

waterfall_check_job_change

Check whether a contact changed jobs using Waterfall job change detection.

/v1/job/change

7 parameters

Param	Type	Required	Description
company_domain	string	optional	Previous company domain for the contact.
company_linkedin	string	optional	Previous company LinkedIn URL or slug.
contact_linkedin	string	optional	Contact LinkedIn URL or slug.
professional_email	string	optional	Contact professional email address.
personal_email	string	optional	Contact personal email address.
contact_full_name	string	optional	Full name of the contact.
custom_fields	object	optional	Custom metadata to echo back in Waterfall finder responses.

GET

waterfall_get_account_usage

Get Waterfall usage metrics for the authenticated API key and full account.

/v2/account

1 parameter

Param	Type	Required	Description
month	string	optional	Optional month in YYYY-MM format used to scope usage counters.