Tenancy Auto-Activation Sweep
Tenancy Auto-Activation: What It Means for You
Starting with v0.1.195, tenancies no longer need to be manually activated when a new tenancy period begins. A nightly automated sweep handles this for you — so from the moment a tenancy start date arrives, everything just works.
The Problem This Solves
Before this release, a tenancy created in advance with a future start date would remain in upcoming status even after the start date passed, unless someone manually triggered the transition. This created gaps where a live tenancy wasn't reflected as active in the system — affecting compliance checks, deposit workflows, and notifications.
How It Works
Every night at 01:00 UTC, the platform runs a background sweep across all tenancy records. For each tenancy that meets the following criteria:
statusisupcomingstartDateis on or before today's date
The sweep will:
- Transition the tenancy status from
upcoming→active - Fire a
tenancy.updatedevent — available to any downstream integrations or webhooks subscribed to tenancy changes - Send an in-app notification to all organisation admins, confirming the tenancy is now live
Who Gets Notified?
Org admins receive an in-app notification for each tenancy activated during the nightly run. Notifications appear in the platform UI and confirm the tenancy is live.
Tenants and landlords do not receive a separate notification from this sweep — communication around tenancy start dates should continue via your existing onboarding workflows.
Affected Entities
| Entity | Effect |
|---|---|
tenancies | status updated from upcoming to active |
properties | Reflects updated tenancy state |
notifications | In-app alert sent to org admins |
complianceChecks | Compliance context updated to reflect active tenancy |
For Integrations & Webhooks
If your integration listens for tenancy.updated events, activations triggered by the nightly sweep will appear in your event stream just like any manual status update. No changes to your integration are required — the event payload is identical.
Schedule
| Field | Value |
|---|---|
| Cron expression | 0 1 * * * |
| Runs at | 01:00 UTC, every day |
| Trigger type | Scheduled (nightly batch) |
Frequently Asked Questions
Do I need to do anything to enable this?
No. The sweep runs automatically for all organisations.
What if a tenancy start date is in the past but was never activated?
The next nightly run will catch it — any upcoming tenancy with a startDate on or before the current date will be activated.
Can I still manually activate a tenancy before the sweep runs?
Yes. Manual activation remains available and is unaffected by this feature.
What time zone does the sweep use?
The sweep runs at 01:00 UTC. startDate comparisons are made against the UTC date at the time the job runs.