Skip to main content

Agent Task Status Changed

Overview

·Event key:
agent_task.status_changed

This event enables real-time tracking of agent task (reminder) status changes and progress updates. Use it to synchronize task management systems, update CRM records, trigger workflow automations, track agent productivity, and maintain accurate task status across your platform.

When This Event Triggers

This event fires when the status of an agent task (also known as a "Reminder" in the system) changes. Agent tasks are follow-up items assigned to leasing agents to track their work with prospects and residents, such as scheduling callbacks, following up on applications, or completing other leasing-related activities. The event fires in the following scenarios:

  • Task Created — When a new agent task is created, the event fires with the new status (typically "Active") and no previous status.
  • Task Status Changed — When an existing task's status is updated, such as: Active (the task is open and needs attention); Completed (the agent has finished the task); Canceled (the task has been canceled and is no longer needed); Not Applicable (the task is no longer relevant).

This event only fires for companies that have the "Send Task Status Spiderman Messages" feature enabled, which allows task status changes to be communicated to external systems.

The event payload includes:

  • The task ID
  • The renter (client) ID associated with the task
  • The community ID where the task belongs
  • The user ID of the agent assigned to the task (if any)
  • The PMS identifier for the renter (if available)
  • The new status of the task
  • The old status of the task (empty string if this is a new task)

This event is useful for integrating with external CRM systems or Property Management Systems that need to track agent activities and task completion, or for analytics systems that monitor agent productivity and follow-up rates.

Event Payload

Example payloadJSON200 · application/json
{
"id": "8cc87045-cccc-4a16-a882-454044e6762a",
"event": "agent_task.status_changed",
"timestamp": "2024-10-09T13:49:31.658518+00:00",
"data": {
  "task_id": 12345,
  "renter_id": 67890,
  "community_id": 435242,
  "user_id": 98765,
  "pms_identifier": "t1234",
  "new_status": "Completed",
  "old_status": "Active"
}
}