Clay Integration Guide

Setup

1. In Clay, add an HTTP API enrichment step
2. Set the method to GET
3. Set the URL to: https://api.hillwinds.ai/v1/companies/lookup?domain={{company_domain}}
4. Add header: Authorization: Bearer ss_live_YOUR_KEY_HERE
5. Enable flat mode for easier column mapping — append &format=flat to the URL

Company enrichment by domain

GET https://api.hillwinds.ai/v1/companies/lookup?domain={{company_domain}}&mode=full&format=flat

This returns a single flat row with all company fields as simple key-value pairs — ready for Clay column mapping.

Contact enrichment

After enriching the company, pull contacts:

GET https://api.hillwinds.ai/v1/personnel?lead_type=company&company_eins={{enriched_ein}}&seniority=C-suite,VP-Director&has_email=true&format=flat&page_size=5

Building a prospecting list

Use the list endpoint with filters to build a targeted list directly:

GET https://api.hillwinds.ai/v1/companies?states=CA,NY&industries=Hospitals&employee_bands=Mid-market+Accounts&signals=carrier_change&format=flat&mode=full&page_size=100

Tips

• Use format=flat for all Clay requests — it eliminates nested objects
• Use mode=basic to save credits when you don't need relationship data
• Use eb[website]=true to skip companies without websites
• Lookup endpoints (/lookup?domain=) are best for single-record enrichment
• List endpoints are best for building prospecting lists