When you add a tenant in Leja Professional, Leja does more than create a contact record. It silently issues the tenant a Residential Identity Number (RIN) — or links to their existing one if they’re already in the Leja ecosystem — and begins accumulating their payment history from the moment the first rent charge is confirmed. The tenant doesn’t need to take any action for this to happen. Their verified record starts building the moment you add them.Documentation Index
Fetch the complete documentation index at: https://relvor.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Add a tenant
Open the Tenants page
Navigate to Operations → Tenants and click Add tenant.You can also add a tenant directly from a unit’s detail page within a property.
Enter the tenant's details
The tenant’s phone number is required. It is used for RIN deduplication — if a tenant with the same number already exists in the Leja ecosystem, Leja links to their existing record rather than creating a duplicate.
| Field | Required | Notes |
|---|---|---|
| Full name | Yes | As it appears on their ID |
| Phone number | Yes | Used for RIN deduplication and identity linking |
| NIN | No | Recommended — links to their verified national identity |
| Email address | No | Optional contact detail |
| Emergency contact | No | Optional |
Link the tenant to a unit
Select the property and unit the tenant is occupying. Then enter:
- Lease start date
- Lease end date
- Agreed rent amount
- Billing frequency (monthly, quarterly, annually)
Leja issues the tenant's RIN
When you save the tenant record, Leja silently issues a RIN at
PROVISIONAL tier. No notification is sent to the tenant at this stage. Their payment history begins accumulating as you confirm payments against their rent charges.If the tenant’s phone number matches an existing record in Leja (from a previous tenancy, or because they already use Leja Resident), their new tenancy is linked to that existing RIN. No duplicate record is created.About NIN and RIN
The NIN (National Identification Number) is optional when adding a tenant, but entering it strengthens the tenant’s identity record. A tenant with a linked NIN has a higher-trust profile in the Leja ecosystem than one identified by phone number alone. The RIN (Residential Identity Number) is Leja’s identity layer for tenants. It is:- Issued silently when you add a tenant
- Linked to their phone number (and NIN if provided)
- Permanent — it follows the tenant across all future tenancies, not just the current one
- The anchor for their verified payment history
RIN deduplication
When you add a tenant with a phone number that already exists in Leja, the system links the new tenancy to their existing RIN automatically. You’ll see a confirmation that an existing record was found and linked. This matters because it means:- A tenant you’ve managed before retains their full payment history across all their tenancies
- A tenant who joins Leja Resident (the consumer side) will have their professional rental record connected to their personal identity
- You cannot create two separate records for the same person by accident
If you believe a match is incorrect, contact Leja support before confirming the link. Once a tenancy is attributed to a RIN, the record is permanent.
Tenant lifecycle
A tenant in Leja Professional moves through the following stages:| Stage | What it means |
|---|---|
| Added | Tenant record created, RIN issued, no charges yet |
| Active tenancy | Rent charges created, payments being confirmed, history accumulating |
| Lease expiry | Lease end date reached — both parties confirm clean exit; tenancy closes |
| Early exit | Tenant leaves before lease end — early termination recorded as a witnessed event |
| Departed | Tenancy closed; tenant’s RIN retains the full history of the tenancy |
What the tenant’s payment history captures
Every payment you confirm for a tenant creates a witnessed payment event in their history. Leja classifies each payment automatically:| Event type | When it applies |
|---|---|
| Payment on time | Paid within the grace period |
| Payment late | Paid 1–7 days after the due date |
| Payment very late | Paid 8 or more days after the due date |
| Partial payment | Less than the full amount was paid |
| Payment missed | No payment received past the threshold |