Error Messages Explained
When something can’t be completed, Clorvia shows a short message (usually a small toast in the corner, or a note under the field you’re editing). This page lists the messages you may see, why they happen, and how to fix them.
Tip: the message text tells you the reason. If you ever see a generic “An error occurred”, reload the page and try again — if it keeps happening, contact support with a screenshot.
Sign-up & sign-in
| Message | Why it happens | What to do |
|---|---|---|
| A user with this email already exists | An account is already registered with that email. | Use Sign in instead, or reset your password. |
| Email must be a valid email | The email address is mis-typed (missing @ or domain). | Check the spelling and try again. |
| Password must be between 8 and 50 characters | The password is too short or too long. | Use at least 8 characters. |
| Full name is required | Sign-up needs your name for your workspace profile and invoices. | Enter your full name. |
| Company name is required | Your company name becomes your workspace name and appears on invoices. | Enter your business / company name. |
| A valid phone number is required | The phone field is empty or incomplete. | Enter your 10-digit mobile number (the +91 is added for you). |
| Invalid email or password | The email/password combination doesn’t match an account. | Re-check both. Use Forgot password if needed. |
| Captcha verification failed | The anti-bot check didn’t pass (often a slow network or an expired page). | Reload the page and try again. |
Your session
| Message | Why it happens | What to do |
|---|---|---|
| Your session has expired / you’re sent back to sign-in | For your security, sign-in sessions don’t last forever. | Sign in again. Your data is safe. |
| Unauthorized | You’re not signed in, or your session ended. | Sign in again. |
Plans, billing & feature access
Clorvia has Free, Starter, Professional and Business plans, plus a 14-day free trial. Some features are only on higher plans — see Plans & Billing.
| Message | Why it happens | What to do |
|---|---|---|
| Upgrade required for this feature | The feature you tapped isn’t included in your current plan. | Open Settings → Plans and upgrade. The message names the plan you need. |
| Subscription not active | Your trial ended (or a paid plan expired) and you’re on the Free plan, which doesn’t include this feature. | Subscribe or renew in Settings → Plans. |
| API not available on your plan | The Developer REST API and MCP access require the Business plan (or an active trial). | Upgrade to Business, or use the app directly. |
| Payment failed | The bank/card declined the payment, or it was cancelled. | Try again, use a different method, or contact your bank. No charge is taken on a failure. |
| Payment is still processing | The bank hasn’t confirmed the payment yet. | Wait a few minutes — Clorvia activates your plan automatically once the bank confirms (even up to an hour later). No need to pay again. |
Important: you are never double-charged. If a payment is stuck, wait for the confirmation rather than paying again — the plan activates on its own when the bank confirms.
Workspace & team members
| Message | Why it happens | What to do |
|---|---|---|
| The workspace owner cannot be removed | The account that created the workspace is its permanent owner and can’t be removed or leave. | To hand over a business, contact support. Other members can still be removed normally. |
| Member not found | The member was already removed, or the page is out of date. | Reload the Members page. |
| You don’t have permission to do this | Your role doesn’t allow that action. | Ask the workspace owner to do it or to update your role. |
Saving records (invoices, items, parties…)
| Message | Why it happens | What to do |
|---|---|---|
| An item / customer with this name already exists | Names must be unique within a company. | Use a different name, or edit the existing record. |
| This field is required | A mandatory field (e.g. invoice date, party) is empty. | Fill the highlighted field. |
| Invalid value | The value doesn’t fit the field (e.g. letters in an amount, a bad GSTIN). | Correct the highlighted field. A GSTIN is 15 characters. |
| Not found | The record was deleted, or you opened an old link. | Go back and reload the list. |
Developer API errors
If you use the REST API, errors come back as JSON with an
error message and the matching HTTP status:
| Status | Meaning | Common cause |
|---|---|---|
| 400 Bad Request | The request body is invalid. | A missing or mis-typed field. Check the error text. |
| 401 Unauthorized | The API key is missing or wrong. | Send Authorization: Bearer <API key>. Create one in Settings → Developers. |
| 402 Payment Required | API not available on your plan. | Upgrade to Business (or use it during your trial). |
| 403 Forbidden | The API key lacks permission for that action. | Use a key with the right access. |
| 404 Not Found | The record or endpoint doesn’t exist. | Check the ID and the URL path. |
| 429 Too Many Requests | You’re sending requests too fast. | Slow down / retry after a short pause. |
See Using the API for examples.
Still stuck?
If a message isn’t listed here, or the fix didn’t help:
- Reload the page and retry once.
- Note the exact message, the screen you were on, and what you were doing.
- Contact support with that information (a screenshot helps).