lead.rental_alert

lead.rental_alert fires alongside lead.enriched when the lead-score assessment reports an occupancy defect. That includes entity-owned properties (LLC, trust) where owner occupancy is unknown. It does not fire because owner_occupied is false. property.owner_occupied in this payload is the raw enrichment value and still passes through unchanged. rental_alert can be true while owner_occupied is null (entity owner) or, rarely, true (a rental signal from the data provider). Field name, boolean type, and position are unchanged.

lead.enriched remains required for all subscriptions.

Lead payloads include:

{
  "source_tracking": {
    "widget_version": "01",
    "widget_name": "Primary",
    "source_code": "01",
    "source_label": "Website"
  }
}

{
  "event": "lead.rental_alert",
  "event_id": "uuid-v4",
  "timestamp": "2026-04-06T14:22:00Z",
  "organization_id": "b8ff2073-228d-4f0f-b5db-28b49cf4069e",
  "data": {
    "lead_id": "b543b8ca-87ff-45e9-8d04-65c61853c853",
    "flow_id": "ad64cf83-45d9-4f72-a57a-c028f0678fdc",
    "source_tracking": {
      "widget_version": "01",
      "widget_name": "Primary",
      "source_code": "01",
      "source_label": "Website"
    },
    "contact": {
      "first_name": "Rhett",
      "last_name": "Butler",
      "address": "4355 Candacraig, Johns Creek, GA"
    },
    "property": {
      "owner_occupied": false,
      "rental_alert": true
    },
    "spark360_scores": {
      "lead_integrity_score": 7
    }
  }
}

The example above is one valid case: an occupancy defect where owner_occupied is false. The same event is sent when owner_occupied is null or true, as long as the occupancy defect is present. rental_alert in this payload is true because the event only fires for that defect.

Changelog

2026-09-30

Corrected the trigger and the payload flag. lead.rental_alert now fires when the lead-score assessment reports an occupancy defect, including unknown occupancy on an entity-owned property. It no longer fires on owner_occupied === false.
property.owner_occupied remains the raw value. It is no longer hardcoded to false.
Event name, rental_alert field name, boolean type, and key position are unchanged.
trust_alert and business_alert were added on lead.enriched only. They are not on this event.

Getting Started

Events

Payload Reference

Security

Delivery & Reliability

Testing

Changelog

​Changelog

Changelog