Leads

The leads module manages inbound buyer/seller inquiries from portal ingestion to deal conversion.

Lead Buckets

Real-Time Updates

The lead pool subscribes to Supabase Realtime. When a new lead arrives, the inbox updates instantly without a page refresh.

// Supabase realtime subscription (simplified)
supabase
  .channel('leads')
  .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'leads' }, 
    (payload) => { /* update inbox */ })
  .subscribe()

Claiming a Lead

POST /api/leads/[id]/claim
Authorization: Bearer <jwt>

Returns 200 OK with the updated lead. Returns 409 Conflict if already claimed.

Lead to Deal Conversion

POST /api/dashboard/leads/[id]/convert
Authorization: Bearer <jwt>
Content-Type: application/json
 
{
  "listing_id": "optional-listing-uuid",
  "initial_stage": "new"
}

Creates a deal record and links it to the lead. The lead status updates to converted.

Lead Sources