Enrich companies on any webhook request
Build a webhook endpoint that accepts company identifiers (domain or name) via HTTP requests, enriches them with Lusha’s verified firmographic data, and returns the complete company profile as a JSON response—so any system can get enriched data on-demand without direct Lusha API integration.
Why this works
Most teams have systems that need company data but can’t easily integrate with Lusha directly: custom internal tools, no-code apps, legacy systems, or workflows that need enrichment as a service.
Building a custom enrichment API from scratch means handling authentication, rate limiting, error handling, response formatting, and infrastructure. This play removes all of that—Pipedream gives you a production-ready webhook endpoint, and Lusha provides verified company data. You just connect them.
What you get
- Custom HTTP endpoint that accepts company enrichment requests from any system
- Real-time Lusha enrichment that returns verified firmographic data in seconds
- JSON response with industry, employee count, revenue, location, funding, tech stack, and more
- No infrastructure management – Pipedream handles hosting, scaling, and uptime
- Flexible integration that works with internal tools, automation platforms, apps, or custom code
How to set it up
Use the Pipedream template
Start from the “Enrich Companies with Lusha API on New Requests from HTTP / Webhook API” template. It includes the HTTP trigger and Lusha enrichment step pre-configured.
Deploy the HTTP webhook trigger
Pipedream automatically creates your custom endpoint URL when you activate the workflow. Copy this URL—you’ll use it to send enrichment requests.
Test the webhook endpoint
Send a test request to verify the endpoint is working:
bash
curl -X POST https://[your-unique-id].m.pipedream.net \
-H “Content-Type: application/json” \
-d ‘{“company_domain”: “salesforce.com”}’
Confirm Pipedream receives the request successfully before adding enrichment.
Connect Lusha Company API
Add your Lusha API key to the Lusha enrichment step. Map the incoming request field (company_domain or company_name) to the Lusha API input.
Configure the response
Set up the HTTP response to return enriched company data:
- Map Lusha fields to the response JSON
- Add status codes (200 for success, 404 if not found, 500 for errors)
- Include enrichment metadata (timestamp, status, confidence)
Add error handling
Configure fallback logic for edge cases:
- Company not found in Lusha → return 404 with clear message
- Missing required fields → return 400 validation error
- API rate limit hit → return 429 with retry-after header
Test end-to-end
Send real enrichment requests and verify:
- Lusha returns company data
- Response includes all expected fields
- Error cases are handled gracefully
- Response time is acceptable (should be <3 seconds)
What to do next
- Add authentication: Require API keys or tokens in the request header to secure your endpoint
- Enable batch enrichment: Accept arrays of companies in a single request for bulk enrichment
- Add caching: Store enriched results in Pipedream’s built-in data store to reduce duplicate API calls
- Build retry logic: Automatically retry failed Lusha calls with exponential backoff
- Monitor usage: Track request volume, success rates, and response times in Pipedream’s logs
- Connect to your apps: Use this endpoint from Zapier, Make, custom scripts, internal tools, or anywhere that can make HTTP requests
The goal: Any system can enrich company data on-demand with a simple HTTP request—no custom API infrastructure, no complex integration, just send a domain and get verified firmographics back instantly.
No FAQ items available at this time.
Ready to build this?
Get started with Lusha and set up this play in minutes.
