Troubleshooting Company Management
Common issues and solutions for company management
Troubleshooting Company Management
This guide covers common issues you may encounter when working with companies in Rahal.
Quick Diagnosis
| Problem | Most Likely Cause | Quick Fix |
|---|---|---|
| Users can't register | Domain not verified | Add domain to company |
| Users register but can't login | Auto-signup disabled | Activate user manually |
| Searches return empty | Booking engine not configured | Add OAuth credentials |
| All users blocked | Company deactivated | Reactivate company |
| Company not visible | Company deleted | Contact platform admin |
Domain Verification Issues
Users Can't Self-Register
Symptom: Users see "No company found for this domain" when trying to sign up.
Diagnosis:
- Check the company's verified domains list
- Verify the company is active
- Confirm the exact domain spelling
Solutions:
| Cause | Solution |
|---|---|
| Domain not in verified list | Add the domain to company settings |
| Typo in domain | Fix the spelling in verified domains |
| Company inactive | Activate the company |
| Company deleted | Contact platform admin to restore |
Subdomain Users Can't Join
Symptom: Users with subdomain emails (e.g., sales.acme.com) can't register.
Cause: Subdomain matching is exact, not hierarchical.
Solution: Add each subdomain explicitly to verified domains (e.g., acme.com, sales.acme.com, engineering.acme.com).
Adding acme.com does NOT automatically include sales.acme.com. Each subdomain must be added separately.
"Domain already in use"
Symptom: Cannot add a domain to your company because another company has it.
Cause: Each domain can only belong to one company.
Solutions:
- Verify you're adding the correct domain
- Contact platform admin to investigate the conflict
- Check if domain was previously assigned to a test/demo company
Auto-Signup Issues
Users Register But Can't Login
Symptom: User completes registration but login fails.
Diagnosis:
Common causes:
| Cause | Solution |
|---|---|
| Email not verified | User must click verification link |
| Auto-signup disabled | Admin activates from Users page |
| Company inactive | Activate the company |
| Wrong password | Reset password |
Auto-Signup Setting Changed
Symptom: Confusion about which users need approval.
Behavior:
- Changes only affect future signups
- Existing users are NOT affected
- Inactive users remain inactive
- Active users remain active
OAuth Users Also Pending
Symptom: Google/Microsoft login users are also stuck pending.
Cause: Auto-signup setting applies to ALL registration methods.
Solution:
- Enable auto-signup, or
- Manually activate each OAuth user
Booking Engine Issues
Searches Return No Results
Symptom: Flight/hotel searches return empty.
Diagnosis:
- Check if booking engine credentials are configured
- Verify credentials are correct
- Check if URLs are accessible
Solutions:
| Cause | Solution |
|---|---|
| No credentials configured | Add booking engine settings |
| Invalid client ID/secret | Verify credentials with supplier |
| Wrong base URL | Correct the API endpoint |
| Expired credentials | Request new credentials |
| Network issues | Check URL accessibility |
Authentication Errors
Symptom: Errors about invalid tokens or authentication failures.
Diagnosis:
- Check token URL is correct
- Verify OAuth scopes are correct
- Confirm credentials haven't expired
Solutions:
| Error Type | Solution |
|---|---|
| Invalid client | Check client ID |
| Invalid secret | Re-enter client secret |
| Invalid scope | Verify scopes with supplier |
| Token URL unreachable | Check URL format and accessibility |
Cannot Update Credentials
Symptom: Can't see or modify existing secret.
This is expected behavior. Client secrets are never displayed for security.
Solution:
- Leave secret field blank to keep existing
- Enter new value to replace existing
- You cannot view the current secret
Company Status Issues
Users Suddenly Blocked
Symptom: All company users can't access the system.
Most likely cause: Company was deactivated.
Diagnosis:
- Check company status in Companies list
- Look for "Inactive" status badge
Solution: Activate the company to restore access.
Cannot Reactivate Company
Symptom: Can't change company back to active.
Possible causes:
| Cause | Solution |
|---|---|
| Missing permission | You need WRITE_COMPANIES permission |
| Company deleted | Contact platform admin |
| Technical issue | Check for error messages |
Company Disappeared from List
Symptom: Company is not visible in the list.
Cause: Company was soft-deleted.
Solution: Contact platform administrator to restore.
Creation Issues
"Slug already exists"
Symptom: Cannot create company with desired slug.
Cause: Slugs must be globally unique.
Solutions:
- Choose a different slug
- Add a suffix (e.g.,
acme-corpinstead ofacme) - Check for deleted companies with same slug
Required Fields Missing
Symptom: Form won't submit.
Required fields:
- Company Name
- Slug
- At least one verified domain
Invalid Domain Format
Symptom: Domain validation error.
Common mistakes:
| Wrong | Correct |
|---|---|
@acme.com | acme.com |
http://acme.com | acme.com |
acme (no TLD) | acme.com |
acme .com (space) | acme.com |
Multi-Company Issues
User in Wrong Company
Symptom: User appears in unexpected company.
Cause: Email domain matched a different company.
Solutions:
- Check which company has the domain
- Adjust verified domains if needed
- Create user manually in correct company
Company Settings Not Syncing
Symptom: Expected company has no policies/budgets.
Clarification: Each company is completely isolated. Settings don't sync between companies.
Solution: Configure policies/budgets separately for each company.
Getting Help
If you can't resolve an issue:
-
Document the problem:
- Company name/ID
- Exact error message
- Steps to reproduce
- Expected vs actual behavior
-
Check related areas:
- User status (if login issue)
- Role permissions (if access issue)
- Booking engine logs (if search issue)
-
Contact support:
- Provide documentation above
- Include screenshots if possible
- Note urgency level