LeadStatusUpdateInput

Input model for updating a lead's status.

This model is used when transitioning a lead through different stages of the qualification process. Different status values may require specific additional fields (e.g., STUCK requires status_notes, DISQUALIFIED requires disqualified_reason).

  • status
    Type: LeadStatusenum
    required

    New Status - The status to transition the lead to. Each status may have specific requirements for additional fields

    values
    123456
  • closedAsQualifiedReason
    Type: integernullable

    Qualification Reason - Required when status is CLOSED_QUALIFIED. Specifies why the lead was marked as qualified

  • disqualifiedCompanyReason
    Type: integernullable

    Company Disqualification Reason - Optional reason for disqualifying the entire company, not just this lead

  • disqualifiedReason
    Type: integernullable

    Disqualification Reason - Required when status is DISQUALIFIED. Specifies why the lead was disqualified

  • disqualifyCompany
    Type: booleannullable

    Disqualify Company Flag - If true, marks the entire company as disqualified, not just this lead

  • disqualifyPerson
    Type: booleannullable

    Disqualify Person Flag - If true, marks the contact person as disqualified for future leads

  • statusNotes
    Type: stringnullable

    Status Notes - Additional context about the status change. Required when status is STUCK. Maximum 8192 characters