Tenants Now Automatically Notified When Their Deposit Is Released

v0.1.200 · Notification Workflow

---

One of the most stressful moments at the end of a tenancy is waiting to find out whether your deposit has been returned. Starting with this release, tenants no longer have to chase — they'll receive an automatic email the moment their deposit release is initiated.

What changed

We've introduced a new event-driven workflow that fires whenever a deposit release is initiated on the platform. As soon as the initiateRelease mutation completes, a deposit/release.released event is emitted. The platform picks that up immediately and dispatches a tenancy/deposit.released email to every tenant on the tenancy — no manual steps, no delays.

Why it matters

Transparency is at the core of what we're building. Tenants deserve to know the status of their deposit without having to ask. This notification closes the communication gap between the moment a landlord or agent acts and the moment a tenant finds out, helping to:

• Reduce inbound tenant queries about deposit status.
• Build trust by keeping all parties informed in real time.
• Support compliance with the Renters' Rights Act by ensuring tenants receive timely, clear communication about their deposit.

How it works under the hood

The workflow is fully event-driven. The initiateRelease mutation now emits a new deposit/release.released event on success. A listener picks this up and calls the depositReleasedEmailFn handler, which looks up all tenants linked to the tenancy and sends each one a personalised email using the tenancy/deposit.released template.

Because this is event-driven, it's decoupled from the release flow itself — the release process is unaffected, and the notification layer can be extended independently in the future.

---

For technical integration details, see the Deposit Released — Tenant Email Notification feature page.