Create a tenant/client record
Follow the code-backed create a tenant/client record workflow.
Exact navigationAdmin Area → HMO Manager → Clients/Tenants → Add Tenant
Before you begin
- Use the exact navigation above and confirm the intended record, tenant, customer, property, document or date range.
- Confirm module activation and the stated permission instead of using another staff member’s account.
- For public, email, provider, finance, signature or destructive actions, use a controlled test record before production use.
What this guide covers
Follow the code-backed create a tenant/client record workflow. These instructions follow the supplied module’s live menus, controller actions, form fields, model validation and downstream effects.
Exact step-by-step process
- Sign in to the staff admin area and open Admin Area → HMO Manager → Clients/Tenants → Add Tenant.
- Confirm that your account meets the access rule: HMO Manager: Create.
- Open the required record or configuration and review its current values before making a change.
- Complete the displayed fields or action exactly as described in this guide.
- Save, submit, download or confirm the action using the button presented by the module.
- Reopen the source record and verify the expected status, output, notification, file or linked record.
Fields, choices and supported possibilities
First namefirstname
Last namelastname
Emailemail
Phonephone
Companycompany
Addressaddress
Citycity
Statestate
Postcodezip
Countrycountry
Move-in datemove_in_date
Propertyproperty_id
Category/help-centre/category/hmo-manager/
Topic/help-centre/topic/hmo-manager-clients-tenants/
Code-backed validations and workflow rules
- The workflow creates or links a native CRM customer/contact according to the controller/model path.
- Verify the resulting client and property relationship before adding occupancy or KYC.
Expected result and verification
- The create a tenant/client record workflow completes without bypassing the module’s permission and validation checks.
- The saved value, generated file, status, notification or linked CRM record is visible from the same workspace.
- Any validation message remains visible until the source data or setting is corrected.
Security, privacy and operational checks
- Use least-privilege staff access and do not use another person’s account to reach a hidden action.
- Review personal, financial, identity and compliance data before sending, exporting or exposing it through a public link.
- Test configuration, email, public forms, accounting effects and provider connections with controlled records before production-wide use.