Create a requisition and parse a JD
Upload a job-spec document or paste the JD — either way it's parsed into structured, weighted skills and a private email intake address.
A requisition is one role you're hiring for: it holds the parsed job description, the skill priorities that drive ranking, and the candidates in play. You need a recruiter workspace first.
Step 1 — Create it
From Requisitions, click New requisition. Two ways in, both fully parsed:
- Upload a job-spec document — the dropzone accepts a PDF, DOCX or TXT job spec. You can leave the title blank; it's read from the document.
- Paste the full JD into the job-description box.
Add the role title and company/client if you have them, then click Create requisition.
What parsing gives you
- Structured JD — requirements and preferred qualifications split out, plus experience level, employment type and location where stated.
- Extracted skills — each skill becomes a weighted row (required skills are tagged req) ready for your 1–5 priority sliders — see weighting and ranking.
- A private intake address — every requisition gets its
own
req-k4f2-9xqm@inbound.a1ergo.techaddress: eight characters, no look-alike letters, grouped so you can read it down the phone. The dash is only there to help you read it —req-k4f29xqm@…andREQ-K4F2-9XQM@…arrive at the same role. Roles created before August 2026 kept their longer address and it still works.
The summary strip and its drawers
The requisition page opens with a summary strip that always shows what the ranking is based on: how many skills are weighted, and the role's inbound address — click the address box itself to copy it. Click Job spec to see the job description — what you gave us and what A1 pulled out to rank against (a green ✓ on the button means a spec is parsed) — and Configure to open the Requisition setup drawer with the skill sliders and screening gates. Each drawer slides in from the right and closes with Esc or the ✕, so your ranked list never moves while you use it.
If Configure carries a small amber dot, something on this role is still unfinished — most often a day rate captured without a rate model, which looks configured but screens nobody. Open the drawer and the amber panel at the top names exactly what to fix. The dot clears itself the moment you save it; there is nothing to dismiss.
Email intake: forward candidates in
Under Add candidates, the "Forward an email" card explains the intake flow: forward (or BCC) a candidate's email to the requisition's address and the CV attachment lands in this requisition, parsed and ranked automatically. No manual upload step.
Other ways candidates arrive
- Bulk upload — the candidates area has a Bulk upload candidate CVs page with an Upload & parse action.
- Claiming a verified pack — a candidate-shared pack can create the whole requisition for you, parsed job and skill weights included.
Lifecycle
The manage menu on the requisition header covers Edit requisition, Mark filled, Close / archive and Reopen (all reversible), and a permanent Delete requisition that only an Owner can use.