LeadTriggered

LeadTriggered is the non-monetary equivalent of SaleTriggered. It fires when a form submission or signup action occurs, allowing Siren to track lead-based conversions through the same attribution pipeline that handles sales. Form-based integrations like Gravity Forms use this event instead of SaleTriggered. See Form Submitted for a user-level overview of how form-based engagement tracking works.

The event ID is lead_triggered, and its fully qualified class is Siren\Commerce\Events\LeadTriggered.

What does this event carry?

The event carries an opportunity ID and a source string, but no transaction details. Leads have no monetary value at trigger time. Like SaleTriggered, it also accepts optional binding fields to map the event back to an external record.

use Siren\Commerce\Events\LeadTriggered;

$event = new LeadTriggered(
    $opportunityId,    // int: the tracked referral
    'gravity_forms',   // string: source extension
    $formId,           // ?string: external form ID
    'gf_form'          // ?string: external type
);

How does the pipeline react?

InitializeLeadConversion picks up this event and begins the lead conversion process. The downstream pipeline creates conversions and obligations using lead-specific incentive types rather than sale-based ones.

During initialization, the system fires a LeadInitialized event (event ID: lead_initialized), which parallels SaleInitialized in the sale flow. This is an internal coordination point for listeners that need to act during lead initialization before conversions are fully built.

For the full lifecycle of commerce events and how they connect to the rest of the attribution pipeline, see the Commerce Events overview.