CandidatesFor recruiters2 min read

Adding a single candidate

The fastest path to a usable candidate record — name, email, optional resume. Linked to a job at creation or later. Two minutes from form open to invite-ready.

Key takeaways

  • Candidates → *Add Candidate*. Enter name + email. Everything else optional.
  • Linking to a job at creation is optional — you can link later.
  • Uploading a resume triggers automatic parsing (0.05 credits per resume).
  • Candidates can be linked to multiple jobs over time.

When you have a candidate you want to invite to an interview, the first step is to create their record. This article covers the single-candidate flow.

The two-minute path

[@portabletext/react] Unknown block type "undefined", specify a component for it in the `components.types` prop

Required fields

  • Name — used in candidate emails and across the platform.
  • Email — the address that will receive interview invitations.

Everything else is optional. You can fill in details later by editing the candidate.

Resume upload

If you upload a PDF or DOCX, the platform parses it automatically. Parsing costs 0.05 credits per resume — the same as a JD scan.

Parsed fields:

  • Summary / professional bio
  • Work experience (most recent role, employer, dates)
  • Education
  • Skills (as tag chips)

TIP

If you are about to add 20+ candidates with resumes, use [Bulk upload](/knowledge-hub/candidates/bulk-upload) instead — it parses them in parallel and lets you triage in a single screen.

Linking to a job at creation

There's a Link to job dropdown at the bottom of the form. Picking a job creates a JobCandidateMapping — the candidate appears in that job's candidate list immediately.

If you skip this, the candidate is in your global Candidates list but not associated with any role. Link later from the candidate detail page using Add to job.

After creation

You land on the candidate detail page. From here, the most common next steps are: send an interview invite (top-right button), upload supplementary files (Files tab), or add to another job (overflow menu).

Next: bulk-uploading a list of candidates at once.

Frequently asked questions

Can I add a candidate without an email?

No. Email is required because that is how interview invitations are delivered. If you don't have an email yet, capture it before adding the candidate — or use a placeholder you'll update later.

What does resume parsing extract?

Name, contact info, summary, work experience, education, and a list of skills. The summary and skills become editable fields on the candidate profile. The original PDF/DOCX is kept in the Files tab.

Can the same email be used for two candidates?

No. Email is unique within an organisation. If you try to add a candidate with an existing email, the platform will offer to open the existing candidate record instead.

Next steps

Related articles