Internal tenant KYC and checks

Create or edit an internal occupant KYC record

Follow the code-backed create or edit an internal occupant kyc record workflow.

Audience: CRM staffPermission: HMO Manager: Create or EditModule v2.0.1
Exact navigationAdmin Area → HMO Manager → KYC → New/Edit KYC
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 internal occupant kyc 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

  1. Sign in to the staff admin area and open Admin Area → HMO Manager → KYC → New/Edit KYC.
  2. Confirm that your account meets the access rule: HMO Manager: Create or Edit.
  3. Open the required record or configuration and review its current values before making a change.
  4. Complete the displayed fields or action exactly as described in this guide.
  5. Save, submit, download or confirm the action using the button presented by the module.
  6. Reopen the source record and verify the expected status, output, notification, file or linked record.

Fields, choices and supported possibilities

Identitytenant_name, email, phone, nationality, date_of_birth
Documentsid_document_type, id_document_reference, id_document_expiry, kyc_file
Right to rentshare code, reference, method, check/expiry dates, next review
Checksidentity, address, sanctions, PEP, source of funds, risk rating, KYC status
Linkoccupant_id or client_id
Category/help-centre/category/hmo-manager/
Topic/help-centre/topic/hmo-manager-kyc-internal/

Code-backed validations and workflow rules

  • KYC uploads allow PDF/JPG/JPEG/PNG/DOC/DOCX up to 15 MB.
  • Status/check choices must be reviewed against supporting evidence.

Expected result and verification

  • The create or edit an internal occupant kyc 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.