Configure MarqHireAI for production-ready hiring workflows.
A practical operating guide for recruiters, hiring managers, admins, and founders. Follow the steps below to configure your workspace, screen resumes, hand off shortlists to an ATS, and troubleshoot common issues.
Recommended setup order
Best path for first-time teams
Configuration checklist
What admins should configure
These settings control authentication, AI processing, billing, ATS automation, and optional voice interviews.
Supabase URL and anon key
Required for authentication and user sessions.
Supabase service role key
Required for verified server-side recruiting APIs.
Groq or OpenAI key
Required for AI matching, parsing, and interview assistance.
Razorpay keys and plan IDs
Required only when paid checkout is enabled.
SMTP credentials
Optional for support delivery and notification workflows.
App URL
Required so emails, callbacks, and links point to the deployed website.
Voice interview service URL
Required only when voice interview is enabled.
Common environment variables
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEYSUPABASE_SERVICE_ROLE_KEYNEXT_PUBLIC_APP_URLGROQ_API_KEYOPENAI_API_KEYNEXT_PUBLIC_ENABLE_BILLINGRAZORPAY_KEY_IDRAZORPAY_KEY_SECRETSMTP_HOSTSMTP_PORTSMTP_USERNAMESMTP_PASSWORDNEXT_PUBLIC_ENABLE_VOICE_INTERVIEWQuick Start
Set up a workspace, create your first role, upload resumes, and review the AI shortlist.
Create an account from Get Started Free or sign in with an existing workspace account.
Open Workspace and confirm your organization name, plan, and usage limits.
Go to Jobs, create a new job, and paste the job description with must-have skills.
Upload resumes as PDF, DOCX, DOC, or TXT files.
Review the AI match score, shortlist, concerns, and candidate insights before taking action.
Workspace Configuration
Configure the workspace profile, usage limits, team access, and default hiring settings.
Open Settings from the workspace sidebar.
Review Plan and Usage to confirm active jobs, resume scan limits, and enabled features.
Set your organization name so candidate emails and reports use the right company identity.
Invite teammates when your plan supports multiple recruiter seats.
Use role-based access for admins, hiring managers, interviewers, and viewers.
Jobs and Hiring Pipelines
Create roles, manage active hiring pipelines, publish job pages, and track candidates by role.
Go to Jobs and select New Job.
Enter title, department, location, and a complete job description.
Add screening requirements such as skills, experience level, and responsibilities.
Save the job, then upload resumes directly into that job pipeline.
Open each job detail page to export reports, shortlist top candidates, or review low-score candidates.
Resume Screening
Upload candidate resumes and let MarqHireAI parse, score, and summarize fit against the role.
Open Jobs, select a job, then choose Upload Resumes or use the New Job screening flow.
Upload supported files: PDF, DOCX, DOC, or TXT.
Wait for parsing and matching to complete.
Review the match score, matched skills, missing skills, strengths, concerns, and summary.
Shortlist, reject, export, or open the full candidate profile for deeper review.
Candidate Management
Track candidates, update stages, compare profiles, and keep all AI results attached to the candidate record.
Open Candidates to view every candidate across active jobs.
Use search and filters to find candidates by name, status, or role.
Open a candidate profile to inspect resume details, score breakdown, links, and notes.
Update the candidate status as they move through screening, interviews, offer, hired, or rejected.
Use Compare when you need side-by-side evaluation for multiple candidates.
Billing and Plans
Understand plan limits, upgrade flows, annual billing, and payment confirmation.
Open Pricing to compare Free Trial, Early Adopter, Growth, and Pro plans.
Choose Monthly or Annually to view the matching price.
Sign in before checkout so the upgrade can attach to your workspace.
Complete Razorpay checkout when billing is enabled for the deployment.
Return to Settings and verify that Plan and Usage reflect the upgraded plan.
Integrations and Webhooks
Connect external workflows for ATS handoff, inbound resumes, admin support, and AI interview services.
Open Settings to configure ATS webhook handoff when available on your plan.
Paste the external ATS inbound URL and save the configuration.
Use Push to Shortlist from job detail pages to send selected candidates to your ATS.
Enable voice interviews only when the external voice interview service is configured.
Keep API keys and webhook secrets server-side. Never place secrets in client-side code.
ATS webhook path
The exact route for sending shortlisted candidates to an ATS or automation tool.
Open SettingsATS Webhook
Open Settings and find ATS Webhook. Admin or owner access is required to edit it.
Label and URL
Add a provider label such as Greenhouse, Lever, Make, or Zapier and paste the webhook URL.
Turn on webhook push
Enable the toggle and save. The app validates that the destination URL is valid.
Job > Push to Shortlist
From a job detail page, push selected shortlist data to the configured ATS endpoint.
Security and Access
Use secure authentication, role-based workspace access, encrypted services, and careful data handling.
Use strong passwords or configured OAuth sign-in.
Limit admin access to trusted team members.
Review workspace members regularly.
Avoid uploading files that your organization is not allowed to process.
Use Security, Privacy, Terms, and Refund Policy pages for formal policy details.
Troubleshooting
Resolve common setup, upload, billing, email, and interview issues quickly.
If login fails, check the email, password, and email verification state.
If parsing fails, try DOCX or TXT and confirm the file is not scanned or password protected.
If mail fails, send a test email and verify host, port, username, password, and from address.
If billing does not update, refresh Settings and contact support with the payment ID.
If voice interview fails, use the text interview fallback and confirm browser microphone access.
Need help?
Get guided setup support.
If you are setting up MarqHireAI for a team, share your use case with support. Include your workspace email, plan, job volume, and any mail or ATS requirements.
Upload ready
Add resumes directly to jobs for fast parsing and scoring.
Access aware
Use workspace roles and protected routes for team access.
Plan based
Feature access follows your selected plan and usage limits.
Export friendly
Share candidate reports, CSVs, and shortlist data with your team.