What's New: Instant Alerts When Tenants Respond to Deductions

Release v0.1.201

One of the most time-sensitive moments in any deposit negotiation is when a tenant responds to proposed deductions. Agents need to know immediately — whether the tenant has accepted the amounts, raised a dispute, or a mix of both — so they can act quickly and keep the process moving.

With v0.1.201, DepositBase now automatically notifies your agent team the moment a tenant submits their response.

What Changed

We've added a new event-driven workflow that triggers on tenancy/tenant.deduction_response.submitted. When a tenant submits their deduction response through the platform:

An email is sent via the existing tenantResponseEmail handler, summarising what the tenant has accepted and what they are disputing.
In-app notifications are created for every agent in the organisation's team, surfacing the update directly inside DepositBase.

The notification payload carries a complete breakdown — item by item — of the tenant's position, so agents have everything they need in one place without having to go digging.

Why It Matters

Deposit disputes are time-bound. The faster an agent can review a tenant's response and take the next step — whether that's progressing to a formal dispute, negotiating further, or releasing the deposit — the better the outcome for everyone involved.

By making the workflow event-driven, notifications are fired in real time, the moment the submitResponse mutation completes. There's no polling, no manual checking, and no risk of a response sitting unread.

For Developers

If you are integrating with the DepositBase event bus, you can subscribe to the tenancy/tenant.response event to build your own downstream workflows. The event payload includes references to:

tenantDeductionItemResponses — per-item dispute and acceptance data
depositReleases — the associated deposit release record
organizations — the organisation context for recipient resolution

See the feature documentation for full entity and trigger details.

Part of our commitment to keeping every party in the tenancy process informed, compliant, and moving forward.