Tenant onboarding workspace and workflow

Create an onboarding record

Select property and tenant/client or invite recipient and save the initial draft. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: CRM staffPermission: Authorised tenant/rent staffModule v1.0.0
Jump to steps
Where to goAdmin Area → Requests & Applications → Onboarding workspace → New
Before you start
  • Use an account with Authorised tenant/rent staff and confirm the intended record or setting before making a change.
  • Follow the exact route above. If the screen or action is absent, check module activation, ownership and permissions rather than using another person’s account.
  • Use controlled test data for configuration, integration, email, AI, payment, portal or automation changes before production-wide use.

What you’ll accomplish

Select property and tenant/client or invite recipient and save the initial draft. The instructions reflect the supplied module’s registered menus, controller actions, views, settings and code-backed validation flow.

Follow these steps

  1. Go to Admin Area → Requests & Applications → Onboarding workspace → New.
  2. Select the New, Add, Create or Start action exposed on that screen.
  3. Complete the required fields described below and review any linked record, currency, tax, approval or recipient selection.
  4. Save or submit the form once; correct any validation message rather than bypassing it.
  5. Go to the resulting record and verify its number, status, totals, files, activity and downstream links.

Fields and options to review

Exact actionCreate an onboarding record
Exact navigationAdmin Area → Requests & Applications → Onboarding workspace → New
Module version1.0.0
Access ruleAuthorised tenant/rent staff
VerificationReopen the source record and confirm the expected status, linked record, file, notification, portal visibility or financial effect.
Tenant/applicantIdentity, contact, current address, employment/income, occupants, pets, smoker/benefits/children flags and right-to-rent data where exposed.
Tenancy termsProperty, tenant client, start/end/move-in dates, term, rent, frequency, deposit, holding deposit and deposit scheme.
Consent and workflowInvite mode, consents, review notes, agreement template/body, signature stage and workflow action.

Rules the system enforces

  • Fields include property_id, tenant_client_id, recipient_name/email, invite_mode and personal_message.
  • Public application and onboarding actions use token/record checks and explicit workflow states.
  • Do not advance a workflow until the required party, property, dates, financial terms and consent/evidence are complete.

How to confirm it worked

  • The supported create an onboarding record flow completes without bypassing permission or validation checks.
  • The resulting record, setting, status, file, delivery event or external response is visible from the relevant workspace.
  • Unexpected validation, provider or linked-record errors are investigated before retrying.

Security, privacy and operational checks

  • Apply least privilege to purchasing, vendor, invoice, payment, return, contract and report permissions.
  • Verify vendor identity, bank/payment details, tax, currency, totals and approvals before creating financial commitments.
  • Treat public links, signatures, portal files, attachments and exported reports as controlled business records.
  • Test settings and automated jobs with controlled records before production-wide use.