Skip to main content

Appointment Updated

Overview

·Event key:
appointment.updated
⚠️
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 an appointment is created or updated in Funnel Leasing. This event provides information about tour appointments, including scheduling details and status updates.

When this event fires

This event is triggered when:

  • Appointment creation: When a new appointment/tour is scheduled
  • Appointment updates: When appointment details are modified (time, units, etc.)
  • Status changes: When the appointment status changes (completed, cancelled, no-show, etc.)

Event Payload

Example payloadJSON200 · application/json
{
  "event": "appointment.updated",
  "data": {
    "funnel_renter_id": 456,
    "funnel_tour_id": 879,
    "funnel_community_id": 123,
    "pms_unit_ids": ["123", "456"],
    "tour_type": "Guided",
    "start": "2021-08-01 15:00:00",
    "end": "2021-08-01 15:30:00",
    "status": "completed"
  }
}

Appointment Status Values

The status field can have one of the following values:

  • completed - The appointment was successfully completed
  • no-show - The renter did not show up for the appointment
  • cancelled - The appointment was cancelled
  • unknown - The status is unknown or not yet determined

Usage Notes

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

  • Sync appointment schedules with your calendar system
  • Track tour completion rates and no-show statistics
  • Update appointment status in your CRM or Property Management System
  • Link appointments to specific units using the pms_unit_ids array
  • Trigger follow-up workflows based on appointment status (e.g., send feedback survey after completed tours)

The pms_unit_ids array contains the PMS identifiers for units associated with the appointment, allowing you to link the tour to specific units in your system.

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
  • Improved reliability and retry logic
  • Enhanced security features