Leads API
The Leads API provides full control over your lead pipeline through programmatic endpoints. Capture leads from external sources, update their status as they move through your funnel, and retrieve detailed activity histories. This API is essential for teams that integrate ListHouze with third-party lead generation platforms or custom intake forms.
Creating and Retrieving Leads
Use POST /leads to create a new lead with fields for name, email, phone, source, and property interests. Retrieve individual leads with GET /leads/:id or search your full pipeline using GET /leads with filters for status, assigned agent, date range, and lead score. Results include the lead's full activity timeline and associated listing interests.
Lead Scoring and Assignment
The API exposes lead score data calculated by ListHouze's built-in scoring engine. You can also set custom scores via PATCH /leads/:id if you use an external scoring model. Assign leads to agents with the agent_id field, or use the POST /leads/:id/route endpoint to trigger automatic routing based on your team's distribution rules.
Tracking Lead Activity
Every interaction with a lead — emails, calls, property views, and form submissions — is recorded as an activity event. Use GET /leads/:id/activities to retrieve the full timeline. You can also log custom activities with POST /leads/:id/activities to keep all touchpoints centralized in ListHouze.
Info