Renter Status Change

Overview

·Event key:

renter.status-change

⚠️

Legacy Webhook - DeprecatedThis webhook is part of the legacy webhook system. For new integrations, we recommend using the modern webhooks v2 system.

Webhook triggered when a renter's status changes in Funnel Leasing. This event notifies you of status transitions, such as when a prospect becomes an applicant.

When this event fires

This event is triggered when:

• Status transitions: When a renter's status changes (e.g., "Prospect" → "Applicant", "Applicant" → "Approved")
• Workflow progression: When a renter moves through different stages of the leasing process

Event Payload

Example payloadJSON200 · application/json

{
  "event": "renter.status-change",
  "data": {
    "funnel_renter_id": 456678,
    "funnel_community_id": 1234,
    "status": "Applicant"
  }
}

Note: earlier documentation for this event referred to a funnel_team_id field. The payload contains exactly the three fields shown above: funnel_renter_id, funnel_community_id, and status.

Usage Notes

When you receive this event, you can use it to:

• Update renter status in your CRM or Property Management System
• Trigger automated workflows based on status changes
• Update internal dashboards and reporting systems
• Notify relevant stakeholders about status transitions

What counts as a successful delivery: Funnel treats any 2xx HTTP status code as success — it does not check the response body at all, so returning any content (or none) with a 2xx status is sufficient. If your endpoint returns a non-2xx status or is unreachable, Funnel retries the delivery up to 2 more times (3 attempts total), waiting roughly 60 seconds and then 120 seconds before each retry, so your handler must be idempotent.

Migration to Webhooks v2

This legacy webhook is deprecated. For new integrations, we recommend using the modern webhooks v2 system, which provides:

• Better event structure with consistent formatting
• More granular events for different activities
• A dedicated delivery pipeline — see the Webhooks Walkthrough for what's documented about its delivery behavior
• Enhanced security features