Common errors and fixes
Error messages and surprises users most commonly hit, with the one-step fix for each.
"Validation failed" with no field detail on Add user or Add employee
The form passed browser validation but failed the server's stricter check — most often a password shorter than 8 characters.
Step 1: Enter a password of at least 8 characters
Set the temporary password to 8+ characters and resubmit.
"Internal server error" on Add user
A referenced record (a role, department or group) no longer exists in the master. This often happens after a shared colleague deletes an entry mid-session.
Step 2: Refresh the page and reselect roles
Reload the page, pick the roles from the refreshed list, resubmit.
"Email already used" on Add user or Add employee
A user already exists with the same email address. Decide whether to re-use the existing account or pick a different email.
Step 3: Open Admin → Users and search for the email
If the account exists, open it, update roles if needed, and skip creating a duplicate. For employees, tick "Link to existing user" in the login section.
"Employee ID is already in use"
The Employee ID is a unique key within the workspace. Someone else is already using it, or the same code was used for a resigned employee not yet archived.
Step 4: Pick a different Employee ID
Follow your firm's scheme (for example HR-2026-001) and increment. Codes do not need to match date-of-joining order.
Loading… spinner never stops on an employee's Edit page
The user clicked into an employee record their role is not allowed to view. The page waits forever for data that never arrives.
Step 5: Go back and ask HR or Admin
If you need to view an employee's full record, ask HR to share the specific detail or ask Admin to extend your permissions.
Attendance calendar does not reflect the mark I just saved
The browser cached the previous view. The platform does revalidate but a quick round-trip through the list page can show the pre-save state for a few seconds.
Step 6: Hard-refresh the page
On Windows / Linux press Ctrl + Shift + R. On macOS press Cmd + Shift + R. The calendar refetches and the new mark appears.
PDF export returns a 404
Routes with literal paths like /export.pdf must come before parameterised routes like /:id on the backend. A deployment that mixed up ordering shows up as a 404 on export.
Step 7: Try again after a few minutes
If the problem persists, the deployment is stale. Report to support with the exact URL and the time.
WhatsApp message not received by the customer
Three common causes.
Step 8: Check phone format
The phone must be stored in E.164 format (+91XXXXXXXXXX). Open the record and correct the phone if needed.
Step 9: Check template approval in Meta
Open your Meta Business Manager; the template must be in APPROVED state, not PENDING or REJECTED.
Step 10: Check the WhatsApp token in Settings → Integrations
Rotating the token in Meta disconnects the integration. Paste the new token and re-save.
Payment link paid in gateway but not showing in CRM
The gateway webhook did not reach the platform. The payment cleared on the gateway side but no corresponding payment-received entry was created.
Step 11: Open the gateway dashboard and resend the webhook
Find the payment, click "Resend webhook". The platform should pick it up within a minute.
Step 12: If still missing, raise a support ticket
Attach the payment ID from the gateway and the booking code.
"Capacity exceeded" when adding a floor or unit
The child's area pushes the parent plot or floor over its capacity. This is working as intended.
Step 13: Edit the parent plot or floor and bump its area
Open the parent record, update its total area to accommodate the child, save, then retry.
A sidebar entry I expect is missing
Role-gating. The entry is hidden because your role is not granted the permission that controls it.
Step 14: Confirm with your Admin
Ask Admin to either grant your role the perm or assign you an additional role that includes it.
Dashboard shows "Loading…" and never populates
Your role lacks report.read. The platform redirects such users to Attendance by default, but a bookmarked /dashboard URL does not auto-redirect in older sessions.
Step 15: Open the sidebar entry instead
Click your natural landing in the sidebar (Attendance for self-service, HR Executive). If you expect dashboard access, ask Admin to grant report.read.
Imported CSV rejected with "Project code not found" even though the project exists
Case sensitivity. The CSV used prj-mum01 but the project is stored as PRJ-MUM01.
Step 16: Match the exact case used on the project record
Download the sample CSV again — it quotes codes exactly as the system stores them.
My bookmark goes to a 404
The URL may have been renamed in a product update, or you were signed out and redirected to login (which may redirect back to a different landing).