Skip to main content

Authentication & Onboarding Troubleshooting

This guide gathers common issues encountered during account creation, sign-in, and verification, along with steps to resolve them.

1. Issues with verification codes (OTP)​

A. I didn't receive the email verification code​

  • Check folders: Check your Spam, Junk, and Promotions folders. Search for messages from noreply@oikohire.com.
  • Whitelist address: Add noreply@oikohire.com to your email contact list to prevent it from being blocked.
  • Wait for cooldown: The resend button is disabled for 60 seconds. Wait until the countdown completes before requesting a fresh code.
  • Verify spelling: Double-check that your email was typed correctly during signup.

B. I didn't receive the SMS code (Candidate phone verification)​

  • Check formatting: Your phone number must include a plus sign + and country code (e.g. +1... for USA/Canada, +81... for Japan).
  • Network signals: Verify that your phone is receiving cellular signals and can accept SMS text messages.
  • Carrier blocks: Some carriers filter short-code numbers. Contact your provider if you consistently block automated messages.

2. Form validation errors​

A. "Companies must register using a custom domain email..."​

  • Cause: You chose the Company role, but entered a free public email address such as @gmail.com or @yahoo.com.
  • Fix: Use your corporate/business email address (e.g. yourname@yourcompany.com). Candidates are allowed to use free email providers.

B. "Phone number must start with a plus sign..."​

  • Cause: The phone number was entered in a local format without the international prefix.
  • Fix: Prefix the number with + and the country code (e.g., replace 123-456-7890 with +11234567890).

3. Session and redirect errors​

A. "Documentation access expired" / "Invalid ticket"​

  • Cause: The documentation ticket expired (valid for 60 seconds) or was already used.
  • Fix: Go back to the OikoHire application dashboard and click the role guide link again to generate a fresh ticket.

B. "This guide belongs to another role" (403 Forbidden)​

  • Cause: You attempted to open a role guide (e.g., Admin manual) that does not match your active OikoHire user role.
  • Fix: Switch your role in OikoHire or make sure you are logged into an account that possesses the required permissions.

4. ReCAPTCHA errors​

If you receive reCAPTCHA errors when submitting signup or login forms:

  • Ensure JavaScript is enabled in your browser.
  • Disable aggressive ad-blockers or privacy extensions that block third-party scripts.
  • Try logging in using an incognito window or alternate browser.