Instant Notifications for New Tenancies — No More Missed Check-Ins

Release v0.1.354 · Notification · Event-driven

One of the most common friction points at the start of a tenancy is simple: the right people don't know a tenancy exists yet. A branch manager or negotiator only finds out when someone remembers to tell them — or when a check-in deadline is already looming.

With v0.1.354, that changes.

What We Built

We've introduced an event-driven notification that fires the moment a new tenancy is created. The platform automatically identifies which branch is responsible for the property, finds the branch manager and their negotiators, and sends each of them an in-app notification — complete with the tenancy details and a one-click link to kick off the check-in workflow.

No manual handoffs. No digging through the dashboard to find what's new. The right people are informed, instantly.

How Recipient Resolution Works

We didn't want to spam everyone — just the right people. So the notification engine follows a precise lookup chain:

1. The newly created tenancy points to a property.
2. That property is matched to its branch via branchProperties.
3. The branch's members are fetched, then filtered to surface the branch manager and any negotiators (agentRole = 'negotiator').
4. Each of those people receives the notification.

This means the notification list is always accurate, always scoped to the branch responsible, and never over-inclusive.

Why It Matters

The check-in is one of the most important moments in a tenancy. It's where the condition of a property is recorded — and that record is what protects both landlords and tenants at the end of the tenancy when deposit deductions are on the table.

A missed or delayed check-in creates gaps in the evidence trail. By notifying branch managers and negotiators the second a tenancy is created, we give them the best possible chance to start the process promptly and thoroughly.

What's in the Notification

The in-app notification includes the essential tenancy details — property address, start date, tenant information — and a direct link into the check-in workflow. One tap and the recipient is exactly where they need to be.

What's Next

This is the first step in a broader set of automated, event-driven workflow nudges. As the platform evolves, expect more touchpoints — at check-out, during dispute windows, and at key compliance milestones — to be handled the same way: automatically, accurately, and with the right person always in the loop.