Create or edit an HMO booking
Follow the code-backed create or edit an hmo booking workflow.
Exact navigationAdmin Area → HMO Manager → Bookings → New/Edit Booking
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 or edit an hmo booking 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 → Bookings → New/Edit Booking.
- Confirm that your account meets the access rule: HMO Manager: Create or Edit.
- 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
Tenanttenant_name, tenant_email, tenant_phone, client_id
Property/roomproperty_id, room_id
Datesbooking_start_date, booking_end_date, move_in_date, move_out_date
Moneyprice_amount, deposit_amount, holding_amount, price_frequency
Statusreserved, confirmed, checked_in, cancelled, completed
Notesnotes
Category/help-centre/category/hmo-manager/
Topic/help-centre/topic/hmo-manager-bookings/
Code-backed validations and workflow rules
- Active status cannot be saved when the room already has another active booking.
- Money values are cleaned to two decimal places or null.
Expected result and verification
- The create or edit an hmo booking 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.