How it works Features Pricing API Log in Start free

How can we help?

Everything you need to get the most out of Aptly

Scorecards Share link Candidate portal Scans Job board PDF reports API
Getting started
👋
Welcome to Aptly — what it does and how it works
+

Aptly is a Candidate Intelligence Platform for recruiters. You upload CVs, Aptly ranks them against your job spec, flags the best candidates, generates a ready-to-send email for every applicant, and produces a shareable shortlist for your client — all in under two minutes.

The three things Aptly solves

  • Screening admin — ranked shortlist with evidence-based reasoning in under 2 minutes, no matter how many CVs.
  • Client visibility — a live branded shortlist link your hiring manager can view and comment on, in real time.
  • Candidate ghosting — every applicant gets a personalised, reasoned response. Nobody is ignored.

Basic workflow

  1. Create a job (paste your spec or let AI build one for you)
  2. Upload CVs — up to 50 at once, PDF or Word
  3. Get a ranked shortlist with scores, reasons, and draft emails
  4. Move candidates through the pipeline as the process progresses
  5. Share the live shortlist link with your client
📝
Creating a job — paste your own spec or build with AI
+

Every screening in Aptly lives inside a job. Jobs keep your candidates, pipeline, interview logs, and client share link all in one place.

Option 1 — Use my own spec

Paste your existing job description, give the role a title, optionally link a client, optionally capture role details (location, work mode, employment type, hours, salary), and you're ready to screen. Takes about 20 seconds.

Option 2 — Build with AI

Answer a short questionnaire (role title, seniority, role details, must-haves, optional context) and Aptly writes a complete, professional job spec. It also flags any issues — unrealistic requirements, conflicting criteria, missing information — before you screen a single CV. This produces noticeably better screening accuracy than a rough paste.

💡

The Client context field (e.g. "budget-conscious, exact 2 to 5 year band") and the Client priorities sliders directly influence how candidates are scored. Use them whenever you have specific hiring priorities. Each slider (Technical, Industry, Seniority, Culture) defaults to Normal; set Less to down-weight that axis, or More to up-weight it. The scorer applies up to a 10-point adjustment per slider, capped at 25 points total across all sliders.

✏️
Editing a job spec after applications arrive
+

You can edit the title, job specification, client context, and client priorities sliders on any open job by opening the Job details tab and editing the relevant fields. Save changes to apply.

When you edit job specification, client context, or client priorities, candidates who were scored against the previous version of the spec will show a "Scored before update" chip next to their score. Hover the chip to see the dates.

To get a fresh score against the current spec, click the re-screen button on the candidate row. Each re-screen uses 1 scan. The new score replaces the old one.

Title edits do not trigger the re-screen warning because title is not used by the scoring engine.

🔢
What is a scan and how are they counted?
+

One scan = one CV processed against a job spec. If you upload 10 CVs, that costs 10 scans. Scans are used at the point of screening — not when you create a job or view results.

Scan limits by plan

  • Free — 50 scans total, 3 active jobs
  • Starter — 500 scans/month, 10 active jobs
  • Pro — 2,000 scans/month, unlimited jobs
  • Agency — 7,500 scans/month, unlimited jobs

Monthly scans reset on your billing renewal date. You can see your usage and reset date on the Home screen and in My Profile.

Top-up packs

If you need extra scans without upgrading, you can buy a one-time top-up pack from My Profile → Personal tab → Plan & billing. Three sizes are available: 50 scans for $19, 150 scans for $49, or 500 scans for $149. Top-up scans never expire and carry over indefinitely. They are drawn on only after your monthly plan allowance is exhausted.

💡

The AI Database Search tool finds matches for a new role from candidates already in your database. Added matches land in the Applied stage with no score; click Screen now to score them, which uses 1 scan credit.

✍️
Filling in your details after sign up
+

If you arrive in Aptly without a complete profile, you see a short prompt titled Just a couple of details before you can use the app. This usually happens after a Google sign-in or for accounts created before Aptly asked for company name.

The prompt asks for three things:

  • First name
  • Last name
  • Company name

All three are required. Aptly uses your company name to generate your job board URL automatically, and your name appears on candidate-facing emails and the client shortlist.

You can update any of these later in My Profile → Personal tab (name) or My Profile → Company tab (company name and job board URL).

💡

If you signed up with email and password, you filled these in at sign-up and you will not see this prompt.

Screening CVs
📁
Uploading CVs and running a screening
+

Open a job and click + Add candidates — this scrolls the page down to the CV drop zone at the bottom of the job. Drop your files in or click to browse. Aptly accepts PDF and Word (.docx / .doc) files.

Limits

  • Maximum 50 CVs per screening batch
  • CVs are processed in parallel batches of 8, so larger uploads are significantly faster than sequential tools
  • A typical 20-CV batch takes 60–90 seconds

Adding more CVs later

You can screen additional CVs into the same job at any time by dropping files into the drop zone at the bottom of the job page. Each new batch is scored against the same job spec and merged into the existing pipeline.

Make sure your job description is complete before screening. Vague or very short job specs produce less accurate scores. The AI needs enough information to judge fit.

🎯
Using Client priorities sliders to improve scoring accuracy
+

Every hiring manager weighs candidates differently. The Client priorities sliders tell the scoring engine which axes to weight up or down for this role.

Four sliders, three settings each

  • Technical match: hard skills, tech stack, credentials. Set to More to penalise gaps harder, Less to credit adjacent skills.
  • Industry experience: sector knowledge and domain credibility. Set to More to prioritise direct-sector candidates, Less to credit transferable experience from other industries.
  • Seniority: leadership scope, gravitas, years. Set to More to weight formal seniority and executive signals heavily, Less to credit high-growth trajectories at slightly lower levels.
  • Culture and soft skills: communication, team fit, personality. Set to More to weight soft signals heavily, Less to focus the score on hard qualifications.

Every slider defaults to Normal, which behaves exactly as the scorer did before sliders existed. Each slider can shift the score by up to 10 points; total cumulative adjustment is capped at 25 points to keep scoring stable when multiple sliders are set.

💡

Sliders are set per-job and can be updated at any time in the Job details card. Changes trigger a re-screen warning on previously-scored candidates so you can refresh them against the new weighting.

🗄️
AI Database Search: find matches in your existing talent pool
+

Every CV you screen is automatically added to your candidate database. AI Database Search compares any candidate's history against a new job spec, so you can pull from people you already have on file before sourcing externally.

  1. Open a job and click the DB search button in the job header
  2. Aptly searches your full candidate pool and returns ranked matches, each with a brief reason explaining why it fits
  3. Click + Add to job to bring a candidate into the job's pipeline. They land in the Applied stage with no score and no verdict.
  4. To get a score and verdict, click Screen now on the candidate row. This runs the AI scoring against the current job spec and uses 1 scan credit.
💡

You only spend a scan on candidates you decide to screen. If a match looks weak from the reason alone, leave it in Applied or remove it without ever scoring them.

Understanding results
🏆
Scores, rankings, and verdicts explained
+

Every candidate receives a score from 0–100 and a verdict. The score reflects overall fit against the job spec. The verdict is a category recommendation:

  • Strong shortlist — Recommend progressing. Strong match on the criteria that matter most.
  • Borderline — Possible. Meets some criteria but has notable gaps. Two email options are generated — one to progress, one to decline.
  • Do not progress — Does not meet the requirements. A respectful rejection email is generated automatically.

Ranking

Candidates are ranked within each verdict category. A rank of #1 means Aptly considers them the strongest overall match — not just the highest raw score.

What factors influence the score?

  • Match against must-have skills and experience in the job spec
  • Seniority alignment (mismatch is a hard penalty — candidates significantly over or under-levelled score below 50)
  • Domain and sector credibility
  • Any client priorities sliders you have set
💡

The scorer uses a two-step process: initial scoring followed by an independent reranker that reviews the top results. This reduces ordering errors on borderline comparisons.

🎯
Scoring confidence and what it means
+

Every scored candidate carries a confidence level alongside the verdict: low, medium, or high. Confidence tells you how reliable the score itself is, not how good the candidate is. A Strong shortlist with low confidence is still a Strong shortlist, but the underlying evidence is thinner than usual and deserves a closer second look.

Confidence and verdict are independent. A Do not progress can carry high confidence if the mismatch is clear-cut. A Borderline can carry low confidence if the CV gave the model little to work with.

Three things can lead to low confidence:

  • The CV shows AI-generation signals (the AI-CV flag is Moderate or Strong). The score is based on potentially unreliable source material.
  • The score sits close to a verdict boundary (within 5 points of 45 or 70). A small change in interpretation could move the candidate into a different verdict band.
  • The CV is sparse and gave the model limited evidence to base the score on.

Where you see confidence:

  • List view and kanban: a small "Low confidence" pill appears on the candidate row or card. Medium and high show no pill (no news is good news).
  • Expand panels, kanban modal, PDF, and client share link: the full confidence level (low, medium, or high) is shown directly under the one-line summary, with the reason in parentheses when confidence is low.
💡

The recruiter app and the client share link both surface confidence the same way. Your client sees the same caveat you do, so a low-confidence Strong shortlist is something to flag explicitly when you walk them through the list.

🤖
AI-CV detection — what the flags mean
+

Aptly analyses each CV for signs that it was substantially generated by AI rather than written by the candidate. This does not disqualify anyone automatically — it is a signal for your own judgement.

  • None — No meaningful AI writing signals detected
  • Mild — Some generic phrasing or structural patterns; could be natural
  • Moderate — Notable AI-style characteristics. Worth a closer look at the CV
  • Strong — Strong signals of AI generation. The CV may not reflect the candidate's actual writing or depth

A brief reason is shown under each flag when you expand a candidate row. Use this as context when deciding whether to probe further at interview.

The hidden gem flag
+

Aptly sets a ⭐ Hidden gem flag on candidates who have a unique or standout credential that might not be obvious from their overall score alone. This could be a rare certification, an unusually relevant prior employer, or domain experience that exactly matches the client's niche.

The flag is designed to surface candidates who might otherwise be overlooked in a score-sorted list. When a candidate has this flag, read the reason — it often explains why a mid-range score still represents a strong potential fit for a specific type of client.

💡

The hidden gem logic is biased towards inclusion — if there's any doubt, Aptly flags it rather than staying silent. You are always the final judge.

📋
Match reasons and gaps - the evidence behind every score
+

Every candidate row expands to show two evidence lists:

  • Why they stand out - specific strengths from their CV that match the role requirements. These are direct references to what is in the CV, not generic praise.
  • Gaps to probe - specific areas where the candidate falls short or where the CV is ambiguous. These are designed to be used as interview prompts.

These are grounded in the actual CV content - Aptly will not invent qualifications or pad the lists. If a CV is thin, the reasons will be thin too.

📄
Viewing a candidate's original CV
+

When a candidate has been screened with a PDF or Word CV, you can open the original document, not just the extracted text.

Select View CV on the candidate profile, the pipeline card, or the candidate detail rail. The button appears only when a stored original is available, so candidates added before this feature, or screened without a readable file, will not show it.

Original CV files are stored privately, scoped to your organisation, and are deleted when you delete the candidate.

Pipeline & stages
🔄
The candidate pipeline — stages and how to use them
+

Each candidate in a job moves through a pipeline that reflects where they are in the process:

  • Applied — Applied via your job board. Not yet screened.
  • Screened — CV has been processed by Aptly. Awaiting your decision.
  • Shortlisted — You have confirmed they are moving forward.
  • Interviewing — Interview scheduled or in progress.
  • Offered — Offer has been made.
  • Placed — Role filled by this candidate.
  • Rejected — Not progressing. Moved to the collapsed rejected section.

Moving a candidate

Click the stage track (the segmented progress bar) on any candidate row to advance them to a new stage. You can also click the Reject button to move them directly to rejected. When you move a candidate to Shortlisted, Interviewing, Offered, or Rejected — a relevant draft email appears automatically for you to review and send.

💡

Rejected candidates are not deleted — they collapse into a separate section at the bottom of the job. You can restore them to Screened at any time.

☑️
Acting on several candidates at once
+

When you need to do the same thing to several candidates, you can select them in a job's list view and act on them together rather than one at a time.

Selecting candidates

Each candidate row in the list view has a checkbox. Tick the ones you want, or use the checkbox in the column header to select everyone currently shown. Selection respects your filters and search, so if you have narrowed the list to one verdict or searched for a name, select-all takes only those rows. Nothing is ever selected for you; you choose every candidate that an action will touch.

This is available in list view. Switch to list with the ≡ List toggle if you are in kanban.

Email selected

Once you have candidates selected, a bar appears with the actions available. Email selected opens a window where you write or paste one message, a subject and a body, that goes to everyone you picked. You see how many candidates will receive it and the names before you send, and you tick a short confirmation so a send is always deliberate. This is one message to the group, not the per-candidate draft you get from the verdict emails. Anyone who has unsubscribed is skipped automatically, and the message tells you afterwards how many were sent and whether anyone was skipped or had no email address on file.

Reject selected

Reject selected moves everyone you picked to the rejected stage in one step. It does not send any email, so use it when you want to clear candidates from the active list without contacting them. If you want to send a rejection message as well, use Email selected first, then reject.

💡

Rejected candidates are not deleted. They collapse into the rejected section at the bottom of the job, and you can restore them to screened at any time.

The Applied stage and the Screen now button
+

The Applied stage holds candidates who have entered a job's pipeline but have not yet been scored. Two flows put candidates here:

  • Job board applications. Anyone who applies through your public job board lands in Applied as a fresh CV.
  • AI Database Search adds. Candidates you bring in from the DB search results land in Applied with no score and no verdict.

Running Screen now

Click ✨ Screen now on any Applied candidate to run the AI scoring against the current job spec. This uses 1 scan credit, generates a score, verdict, match reasons, gaps, and a draft email, and moves the candidate to the Screened stage. From there they progress through the rest of the pipeline as normal.

You can also use ✨ Screen all at the top of the Applied panel to score every unscreened candidate in one go.

💡

Because adding a candidate is decoupled from scoring, you can review job board applicants or DB search matches and decide which ones are worth a scan before spending one.

Kanban view — managing your pipeline visually
+

The kanban view shows your candidates as cards arranged in columns by stage — a visual alternative to the default list view. Both views show the same candidates and are kept in sync.

Switching to kanban

Open any job with screened candidates and click the ⊞ Kanban toggle button at the top right of the candidates section. Click ≡ List to switch back.

What each card shows

  • Candidate name and initials avatar
  • Email address (if available)
  • Score bar and percentage
  • Verdict badge (Strong / Borderline)

Moving a candidate

Click the button on any card to open a stage menu and move the candidate to a different column. The change takes effect immediately and updates the list view at the same time.

Opening a candidate

Click anywhere on a card (other than the ⋯ button) to open a full candidate modal. This shows their score, match reasons, gaps, and all draft emails — so you can action a candidate without leaving the kanban view.

💡

Rejected candidates are not shown in the columns — they appear in a collapsed section below the board, same as in list view. You can restore them from there.

📊
Seeing how a job is performing
+

Every job has a Stats view that gathers how the role is progressing into one place. Open a job and switch to it with the Stats toggle at the top of the candidates section, next to List and Kanban.

Pipeline and conversion

A funnel shows how many candidates sit at each stage from screened through to placed, with rejected counted separately. Below it, conversion rates show what share move from one stage to the next, screened to shortlisted, shortlisted to interviewing, and onward.

Velocity

How long the job has been open, how quickly you reached a first screen, a first shortlist, and a first interview, and the average time candidates spend in each stage. If the role has been filled, you also see time to fill.

Quality

The average score across your scored candidates and the spread from lowest to highest, a breakdown of verdicts and AI-CV signals, and counts of low-confidence scores and hidden gems.

Engagement

A quiet summary of activity on the job: CVs processed, screening runs, client views and comments, references, scorecards, and videos.

💡

Conversion rates and time in stage build up as candidates move through your pipeline, so they appear once there is enough history to report. A job with only a few candidates shows these as not yet available rather than a misleading number.

🎉
Recording a placement and fee
+

When a role is filled, mark the job as Filled using the status dropdown at the top of the job page. A placement modal will appear where you can record:

  • Which candidate was placed
  • The placement fee and currency

Placed jobs and fees are tracked on your Home dashboard. The placed candidate's stage is automatically updated to Placed.

You can edit placement details at any time by clicking Edit placement details on the job page.

📅
Logging interviews against a candidate
+

Expand any candidate row and click 📅 Log interview to record an interview. You can capture:

  • Interview date
  • Format (video, in person, phone, other)
  • Outcome (progressing / pending decision / not progressing)
  • Notes — key impressions, things to follow up

Interview logs are stored permanently on the application and visible whenever you reopen the candidate row.

Interview scorecards
Scorecards: structured interview feedback
+

A scorecard is a structured rubric for evaluating an interviewed candidate against the job's competencies. Each competency is rated 1 to 5 with an optional comment, and the interviewer picks an overall recommendation from Strong no hire, No hire, Hire, or Strong hire.

How this differs from "Log interview"

"Log interview" is for quick post-call notes (date, format, outcome, free text). Scorecards are for structured, multi-rater feedback that can be aggregated across interviewers. Both can coexist on the same candidate; use whichever fits the situation.

Adding a scorecard

Open the candidate from the job page and switch to the Scorecards tab. The tab header holds three buttons side by side: Edit competencies, + Invite interviewer, and + Add scorecard.

  1. Click + Add scorecard
  2. Pick an overall recommendation
  3. Add an optional overall comment
  4. Rate each competency on the 1 to 5 scale, with an optional comment on each
  5. Click Save scorecard

Every active competency on the job's template must be rated before the scorecard will save. Partial scorecards are not accepted, so consensus comparisons stay clean.

The aggregation summary

Once a candidate has 2 or more scorecards, an automatic summary block appears above the individual cards. It shows the average rating per competency and the distribution of overall recommendations across all raters, so consensus and disagreement are both visible at a glance.

💡

Scorecards can come from external interviewers too, not just members of your organisation. See Inviting an external interviewer below.

✏️
Editing the competency template
+

Every job has its own competency template. The same competencies are used on every scorecard for that job, so ratings are directly comparable across interviewers and across candidates within the role.

The first time you open the Scorecards tab on a job, Aptly seeds five default competencies: Technical fit, Communication, Experience match, Cultural fit, and Domain knowledge. You can adjust them at any time.

Opening the editor

  1. Open any candidate in the job and switch to the Scorecards tab
  2. Click Edit competencies

What you can change

  • Rename a competency (✎ icon)
  • Reorder using the up and down arrows next to each competency
  • Remove a competency you no longer want on new scorecards (🗑 icon)
  • Restore a competency you previously removed
  • Add new competencies in the input row at the bottom of the editor as fresh themes emerge from earlier interviews

How removal works

Removed competencies stay attached to existing scorecards, so historical ratings aren't lost; new scorecards no longer see them. To bring one back, click Show removed at the bottom of the editor, then Restore next to the competency you want active again.

💡

Template changes apply only to this job. Other jobs in your organisation are unaffected, so you can tune the rubric per role without touching the rest of the pipeline.

Editing the template after several scorecards exist can shift the aggregation summary. Removing a competency that has already been rated drops it from the per-competency averages, even though the underlying ratings stay attached to each individual scorecard.

📨
Inviting an external interviewer
+

Hiring managers, client-side interviewers, or anyone outside your Aptly organisation can score a candidate without needing an Aptly account. You send them a tokenised link, they fill in the same competency rubric you use internally, and their submission lands alongside your team's scorecards.

Sending an invite

  1. Open the candidate and switch to the Scorecards tab
  2. Click + Invite interviewer
  3. Enter their name, email, and an optional message
  4. Click Send invite

Each invite link is unique to the invitee and expires 14 days after sending.

What the external interviewer sees

A clean public web page (no Aptly account required) showing the role title, the candidate's name, the full competency list, the rating controls, and the recommendation choices. The competency template is the same one your team uses, covered in Editing the competency template above.

Their submission appears in the candidate's scorecard list labelled Submitted by {name} (external), so internal and external feedback stay clearly distinguished in the aggregation summary.

Tracking pending invites

A Pending invites subsection in the Scorecards tab lists every outstanding invitation with its current status:

  • Pending sent, recipient has not opened the link yet
  • Opened the recipient has loaded the page but has not submitted
  • Expired the 14-day window has passed without a submission
  • Revoked you cancelled the invite manually

Actions on a pending invite

  • Copy link to share manually if the email did not reach them
  • Resend the email (limited to once per hour to prevent accidental spam)
  • Revoke to cancel the invite immediately
💡

The invitee's name pre-fills the submission but stays editable, so a forwarded invite still works if the original recipient delegates the interview to a colleague.

Revoking an invite is immediate; the link becomes invalid the moment you click revoke. If the interviewer has already submitted their scorecard, that submission stays intact and continues to count toward the aggregation summary.

Reference checks
🤝
How reference checks work in Aptly
+

Reference checks gather structured feedback on a candidate from people who have worked with them. Aptly handles the full workflow from request through to a downloadable report, with the same candidate-dignity principle that guides everything else: every party knows where they stand.

When you can request references

The References tab appears on the per-application row in your candidate pipeline, alongside Scorecards and Activity. It is available when a candidate has reached Shortlisted, Interviewing, Offered, or Placed. References can be requested at any of these stages, though most recruiters use it once the candidate is in late-stage consideration.

Two ways to collect references

When you click "Request references", you choose between two methods.

Option A: ask the candidate to provide referee details. Aptly emails the candidate with a private link to a short form. They enter the names, emails, and contact details of their references, and Aptly takes it from there. This is the default and most common path. It puts the candidate in control of who they nominate.

Option B: enter the referees yourself. If you already have referee contact details, you can enter them directly when creating the request. Aptly will email the referees immediately. This skips the candidate step and is faster when you have the information to hand.

Both paths send the same referee invitation and use the same reference form. The difference is purely in how you collect the contact details.

How many references to request

You can request 1, 2, or 3 references per round. Two is the default. The choice depends on the role and your client's expectations.

💡

You can add up to 3 custom questions per request. Use these for role-specific things like "Did they manage budget responsibility?" or "How did they handle conflict?". Each custom question can be pick-list (you provide 2 to 5 options) or free text.

📧
What candidates and referees see
+

Aptly's reference workflow uses two hosted forms, both branded and short. Recipients receive a clear email, click through to fill in the form, and the data flows back to you automatically.

The candidate-side form (Option A only)

The candidate receives an email from you, sent via Aptly, with a link to a short form hosted at aptly.pro. They enter the names, emails, optional phone numbers, relationships, companies, and working dates of each referee. The candidate cannot use their own email as a referee email.

Once they submit, Aptly emails the referees directly and notifies you. The link expires after 14 days. If the candidate has not submitted within that window, you can resend the invitation from the References tab.

The referee-side form

Referees receive an email with a link to a short reference form. The form takes about three minutes and is structured around five default questions:

  • How long did you work with the candidate
  • In what capacity did you work together
  • How would you rate their overall performance
  • Would you hire or work with them again
  • What is the single strongest thing about them professionally

Each question is a pick-list with five or six options. The referee can also add optional comments at the end.

If the referee declines

If the referee would prefer not to provide a reference, the form has a clear decline option with space to leave an optional reason. Declined references appear in your report alongside submitted ones, with the reason if provided. The candidate is not told that a referee declined.

💡

The referee invitation comes from your email address via Aptly, so referees can reply to it directly if they have questions, and the reply lands in your inbox.

📋
Tracking, resending, and revoking references
+

Once you have requested references, the References tab on the candidate row tracks progress and lets you take action.

What the tab shows at each stage

For Option A, while waiting for the candidate to provide details, you see "Awaiting candidate to provide referee details" with a "Resend candidate invitation" button.

Once referees have been invited (whether via Option A or Option B), you see a card per referee with their current status:

  • Awaiting: invitation sent, referee has not clicked through yet
  • Opened: referee has opened the form but not submitted
  • Submitted: full response received, click the card to expand the answers
  • Declined: referee declined to provide a reference, with reason if they gave one
  • Expired: the 14-day link has passed without action
  • Revoked: you revoked the invitation manually

Resending and revoking individual referees

For pending referees (Awaiting or Opened), you can Resend the invitation or Revoke it. Resend is rate-limited to once per hour, so the recipient is not spammed. Revoke marks the invitation as cancelled and the referee can no longer submit.

Cancel and start over

If a reference round is not working out, for example if the candidate provided wrong contact details or the referees are unresponsive, the "Cancel all and start over" link at the top of the References tab revokes all pending invitations and opens the request modal for a fresh round. Already-submitted or declined references in the old round are preserved.

Revoke and Cancel are not reversible. If you revoke an invitation, the referee can no longer submit even if you change your mind. Use Resend if you just want to nudge them.

📄
Downloading the reference report
+

Once all referees have submitted or declined, the References tab switches to a "Completed" view, and a "Download report" button appears at the top right of the tab.

What is in the report

The downloaded PDF includes:

  • Your agency logo and name in the header
  • The candidate's name, the role, and the client (if set on the job)
  • A summary count of submitted and total references
  • A side-by-side aggregation table for the five default questions, shown when two or more references were submitted
  • One full section per submitted reference with all five default answers, any custom question responses, and the optional comments field
  • A "Declined references" section listing any referees who declined, with their reason if provided

What happens when you download

The first time you download the report for a given round, Aptly does two things in the background:

  1. Marks the report as viewed, so the candidate stops appearing in your dashboard's "References ready to review" list.
  2. Sends a brief neutral email to the candidate confirming that their references have been received. This closes the loop respectfully without revealing what was said.

Subsequent downloads do not re-send the candidate email. You can re-download the report as often as you like.

What references do not do

Aptly does not use AI to interpret or score reference responses. The content of a reference is private to you and your client. Candidates do not see what their referees said.

References are scoped to a specific application, meaning a specific role. The same candidate may have separate reference rounds for different roles, and each is independent. If you want references for a candidate on a new role, request a fresh round on that role's application.

💡

The downloaded PDF is intended for you and the hiring client. Treat it as confidential, the same as you would any reference call notes.

Video introductions
🎥
How video introductions work in Aptly
+

A video introduction is a short, one-way video the candidate records on their own, before any live interview. You request it, the candidate answers a few questions in their own time, and you watch the answers back when it suits you. It gives you a feel for the person behind the CV without booking an interview slot.

This is not an AI interview. There is no bot asking questions and no automated scoring. The candidate records alone, reviews their own answers, and submits when they are happy with them. You stay the judge of what you see.

When you can request one

The option appears once a candidate has reached Screened, and it stays available through Shortlisted, Interviewing, Offered, and Placed. The candidate needs an email address on file, since the request is sent to them by email.

💡

The questions are generated from the job's interview guide the first time you request a video, and you can edit them. The next article covers how.

🎬
Requesting a video and choosing the questions
+

Open a candidate who has been screened and choose Request video, either from the quick actions in the right rail or from the Video tab on the candidate. Aptly emails the candidate a private link to record against. The link is valid for 14 days.

The questions

The first time you request a video for a job, Aptly generates the questions from that job's interview guide. You can edit them to whatever you want, between one and four questions. Edit them from the job's overflow menu under Video questions, or from the request dialog as you send. Edits apply to future requests, not to links you have already sent.

💡

If you change your mind, you can revoke a pending request from the Video tab at any time before the candidate records. The link stops working straight away.

📱
What the candidate experiences
+

The candidate opens the link and records their answers one question at a time, with around 90 seconds suggested for each. On a phone, their phone's camera opens to record. On a computer, they record in the browser with a live preview, so they can see themselves before they start.

They review each answer and can re-record it before submitting, so what they send you is the take they are happy with. Once they submit, they get a confirmation email. That email includes a link they can use to delete their video early if they would rather it not be kept.

💡

There is nothing for the candidate to install. They record in their browser or with their phone's own camera, depending on the device they open the link on.

📝
Watching videos and keeping notes
+

When the candidate submits, their answers appear in the Video tab on the candidate, where you watch each one back in the app. Alongside the recording you can keep private notes, visible only to you and your team, to capture your read on the person while it is fresh.

Retention

Videos are stored securely and deleted automatically 30 days after they are recorded. Your notes are not deleted with the video, so your read on the candidate stays on the record after the recording itself is gone. The candidate can also delete their video earlier than 30 days using the link in their confirmation email.

💡

You are notified both in the app and by email the moment a candidate submits their video, so you know when there is something new to watch.

Candidate emails
How candidate emails work
+

Aptly generates a personalised, ready-to-send email for every candidate as part of each screening. The type of email depends on their verdict:

  • Strong shortlist — one shortlist email, congratulating and inviting them forward
  • Borderline — two options: Option A to progress, Option B to respectfully decline
  • Do not progress — one personalised rejection that references their background — not a form letter

Sending emails

Expand a candidate row to view and edit the draft. Click Send email to send directly from Aptly, or Copy to paste it into your own email client.

💡

All emails are editable before sending. Aptly generates the draft — you make the final call on what goes out.

Stage-triggered emails — automatic drafts as you move candidates
+

When you move a candidate to a key stage, a relevant draft email appears automatically at the top of their expanded row — no separate step required.

  • Shortlisted — their original shortlist or progress email appears
  • Interviewing — an interview invitation with placeholder date/format fields
  • Offered — an offer notification with placeholder salary/start date fields
  • Rejected — a context-appropriate rejection (different wording for post-interview versus initial screening rejections)

All drafts are editable inline before sending. The email appears highlighted in the context of the stage change so it's impossible to miss.

What if a candidate's email address isn't found?
+

Aptly extracts email addresses directly from CV content. If a CV does not contain a clearly formatted email address, or if the address is embedded in a graphic or image-only PDF, extraction may fail.

In this case, the email preview will show No email address found in red. You can still copy the email body and send it manually from your own email client.

The candidate record in your database will also be missing an email — you can add it manually by opening their profile from the Candidates tab.

Share with client
🔗
Generating and sending the client share link
+

Every job can have a unique share link that lets your hiring manager view the shortlist, candidate scores, and reasoning. You control who can open it by adding viewers to the link's access list.

  1. Open a job and click Share with client
  2. Add who can view the link (specific emails or a whole company domain)
  3. Choose an expiry (7 days up to no expiry)
  4. Tick the acknowledgement and click Generate link
  5. Copy and send the link to your client

Who can view the link

The Who can view this link section sets the access list. Each entry is either a specific email (sarah@company.com) or a whole company domain (@company.com) that lets anyone with that email address get in. You can add up to 10 entries per link. Aptly suggests company domains you have used on other jobs so you do not have to retype them.

How the client opens the link

When the client clicks the link, they enter their email address. If it is on the access list, Aptly sends them a one-time magic link by email. They click that link and land on the shortlist. The link signs them in for 7 days on that browser, so they will not need to verify again the next time they visit.

What the client sees

Your agency logo, the ranked shortlist with scores and evidence, and a comment box on each candidate. They cannot see email addresses or contact details, only the professional screening information.

Recent access

The share modal shows a Recent access log of who has verified and when, so you know which of your invited viewers have actually looked at the shortlist.

Removing access

Remove someone from the access list by clicking the × on their chip. They lose access the next time they load the page, even if they verified earlier. To kill all access entirely, click Revoke link. Regenerating the link with a new expiry also invalidates any old verified sessions.

💡

Existing share links generated before access lists existed continue to work without verification. The gate activates per-link the moment you add your first viewer.

Treat the share link as sensitive. Anyone you put on the access list can view candidate data on this role. Use a specific email when you know who is viewing; use a company domain only when you trust everyone at that domain.

💬
Client comments and notifications
+

Clients can leave comments on individual candidates directly from the share page. You are notified by email when a comment is posted.

Comments are visible to you inside each candidate's expanded row in the job pipeline. Jobs with unread comments are flagged on your Home dashboard with a 💬 badge.

This replaces the need for back-and-forth emails about specific candidates. The client's feedback stays attached to the candidate it relates to.

If you have set an access list on the share link, your client needs to be verified (see the share link article above) before they can post a comment.

Candidate portal
📬
What is the candidate portal?
+

The candidate portal is a personalised, no-login page that shows a candidate their current stage, a brief status description, and their fit profile for the role. It uses your agency logo and branding — no Aptly branding is shown to the candidate.

It is designed to replace the silence that candidates typically experience — they can check their status without calling or emailing you.

What the candidate sees

  • Your agency logo and company name
  • The job title they applied for
  • Their current stage in plain English (e.g. "Your CV is being reviewed" or "You've been shortlisted")
  • A personalised fit profile describing why they are a good match for the role
  • A visual progress track
💡

The fit profile is generated as part of the screening process. It is written in second person and describes the candidate's specific strengths relative to this role — not a generic profile.

📤
Sending a portal link to a candidate
+

Expand any screened candidate's row and click 📬 Send portal link. Aptly will email them a unique, tokenised URL that only they can access — no password required.

The button only appears if the candidate has an email address on file. If it's missing, add it to their profile first.

Each portal link is permanent for that application — the stage shown updates automatically as you move the candidate through your pipeline, so you only need to send it once.

Portal links sent before 16 April 2026 may not have a token. If the send button is missing for an older application, this is why. Clicking Send portal link generates one on demand.

Job board
🌐
Setting up your public job board
+

Your job board is a public page at aptly.pro/jobs/?agency=your-slug that lists all your live jobs. Candidates can view job descriptions and apply directly. Their details arrive in your pipeline as Applied candidates, ready to screen.

Aptly generates a job board slug for you automatically from your company name when you sign up, so your board is ready to share straight away. You can rename the slug at any time from your profile.

Changing your agency URL

  1. Go to My Profile → Company tab
  2. Under Job board URL, edit your agency slug (e.g. nexus-recruitment)
  3. Click Save URL

Your job board URL will be confirmed once saved. Share it anywhere: your website, LinkedIn, email signatures.

If you change your slug after applicants have started arriving, the old URL stops working. Anyone you have shared the old URL with (including LinkedIn job posts) will land on a "not found" page. Change the slug only when you are sure.

🔒
Showing a privacy notice to applicants
+

When candidates apply through your job board, they must agree to a privacy notice. You decide what they see. Three options are available in My Profile → Company tab → Candidate privacy notice:

Link to your existing privacy notice

If your agency already publishes a privacy notice on its website, paste the URL. Candidates clicking the consent link go straight to your page. This is the cleanest option if you have an existing notice.

Paste your privacy text

If you do not have a published notice, paste the text directly. Candidates see it on an Aptly-hosted page styled with your branding, headed "Privacy notice from {your agency name}". Up to 10,000 characters, plain text.

Use the Aptly fallback

If neither a URL nor text is set, candidates see a hand-written general statement covering what to expect when applying to a recruitment agency that uses Aptly: what data is collected, how long it is typically retained, what their rights are, and how to contact you. This protects candidates and you while you decide which of the two options above you want to use.

💡If you set both a URL and text, the URL takes precedence on the candidate-facing page. The text is preserved but the URL is what candidates see.

📢
Posting a job and managing applicants
+

Open any job and click 🌐 Post. A confirmation modal explains what will be made public and shows your job board URL. Confirm to make it live.

When candidates apply

They appear at the top of the job as Applied — unscreened, in a separate panel from your screened candidates. From there you can:

  • Click ✨ Screen next to any individual applicant to screen them (costs 1 scan)
  • Click ✨ Screen all to process the whole unscreened queue at once

Once screened, they join your regular ranked pipeline.

Retracting a job

Click the 🌐 On board button to retract it. The job is immediately removed from your public board. Existing applications are not affected.

🔗
Sharing a single role on LinkedIn or by message
+

Every public job has two share URLs: your full board (lists every live role) and a direct link to one role. The direct link is the one you want for LinkedIn, WhatsApp, or anywhere a preview card matters.

Where to find the links

Open any public job. In the header, click 🔗 Share job board link. A modal shows both URLs with copy buttons. The "This role directly" URL is the per-job link.

What candidates see

The per-job link opens directly to that role's full description with three Apply buttons. No expanding cards, no extra clicks.

LinkedIn previews

When you paste a per-job link into LinkedIn, the preview card automatically shows the role title, your agency name, and your logo. This makes the post look professional and gets more clicks than a generic link.

💡After you post a role to your board, the share modal opens automatically so you can grab the per-job link straight away.

👁
How candidates experience your board
+

It helps to know what your board looks like from the other side. Visit your own URL at aptly.pro/jobs/?agency=your-slug in an incognito window to see exactly what candidates see.

The listing page

Each live role appears as a single clickable card showing the title, client name, and posted date. Clicking the card takes the candidate to the full role page. One card, one click, no nested buttons or expanding sections.

A search bar above the listings lets candidates filter by job title. Three dropdowns alongside it filter by work mode, employment type, and hours. Filter state is captured in the URL, so a candidate can bookmark or share a filtered view (for example, all remote permanent roles) and return to it directly.

The per-role page

The full job spec renders with headings, bullets, and emphasis preserved. Three Apply buttons are positioned at the top, bottom, and as a sticky button while scrolling, so candidates can apply from wherever they reach a decision.

The apply form

Candidates submit name, email, phone, CV, and tick the consent checkbox (linked to whichever privacy option you have set up). They can also opt in to marketing updates. The form is short by design to reduce drop-off.

After applying

They see a thank-you message and receive an email confirming their application. Their details land in your Applied stage, ready for you to screen.

Adding screening questions to a role
+

You can add questions to any role's application form. They help you filter or learn more about applicants before you spend time reviewing them. Open a job, click Manage next to Screening questions (it is also in the job's actions menu), and add as many as you need.

Two types of question

A knockout question is a Yes or No question with a required answer. If an applicant gives the disqualifying answer, they are stopped before they finish applying and see a short message explaining the role is not a match. No application is created, so these never clutter your pipeline. Use these for hard requirements like work authorisation or a required certification.

An informative question is free text. It never blocks anyone; the answer is captured and shown to you alongside the candidate, so you have a bit more context. Use these for things that are useful to know but not deal-breakers.

What the applicant sees

Knockout questions appear first, on their own step. The applicant answers them before they reach the name, CV, and details form, so a disqualified applicant never has to upload a CV. Informative questions sit further down the form with the rest of their details.

Where the answers show up

Every answer, knockout and informative, is recorded on the application. Open a candidate and you will see their answers in the expanded view, next to the score and notes.

💡

Knockout questions only filter honest answers. Someone can still answer the way they think you want, so treat them as a way to save everyone time on clear mismatches, not as a strict gate.

Notifications
🔔
The notifications bell
+

The bell icon in the top nav shows you what needs your attention without sending you to email. A red badge on the bell tells you how many unread notifications you have. Click the bell to open the dropdown and see the most recent ten.

Click any notification to jump to the relevant candidate, job, or page. Notifications are marked read automatically when you click them. Use Mark all as read at the top of the dropdown to clear everything at once.

💡

Notifications update every 60 seconds while the app is open, and refresh immediately when you switch back to the Aptly tab from another tab or window. Multiple tabs of Aptly stay in sync automatically.

📋
What gets a notification
+

You'll get a notification for the following events:

  • New application via your public job board
  • Client comment on a shared shortlist
  • External interviewer submits a scorecard
  • A reference is submitted (or declined)
  • All references received for a candidate
  • A team member accepts your invite
  • You've used 80% of your monthly scans (org owners only)

Email notifications still fire for the events that had them before. Notifications don't replace email; they add an in-app channel so you can catch up without leaving Aptly.

🆚
Notifications vs Needs attention
+

The bell and the Needs attention card on Home answer different questions.

The bell is a log of things that happened. Each notification is a moment in time you can revisit. They stay around even after you've acted on them.

Needs attention on the Home dashboard shows what's currently waiting on you: references ready to review, applicants needing screening. Items disappear from this card the moment you've acted, because it reflects current state, not history.

Use the bell to catch up on what's happened. Use Needs attention to see what's still outstanding.

PDF reports
📄
Downloading the shortlist PDF report
+

The shortlist PDF is a professional, white-labelled report you can send directly to clients. It includes your agency logo, candidate rankings, scores, evidence summaries, and the interview guide.

How to download

Open a job with screened candidates and click the ⬇ Download PDF button at the top of the candidates section. Generation takes a few seconds.

What's included

  • Your agency logo and branding
  • Candidate shortlist — ranked, with scores, verdicts, and evidence
  • AI-CV flag indicators
  • Hidden gem highlights
  • Interview guide (opening questions, technical questions, red flags)
💡

Your agency logo must be uploaded in My Profile → Company tab → Company logo for it to appear in the PDF. PNG, JPG, or SVG, max 500KB.

📑
Exporting the job specification as a PDF
+

You can export the job description itself as a formatted PDF — useful for sending to candidates or keeping on file.

Open a job, expand the Job specification card, and click ⬇ Download spec. The exported PDF includes your job title and the full spec text.

Team & billing
👥
Inviting team members
+

Paid plans include multiple seats. To invite a colleague:

  1. Go to My Profile → Company tab → Team
  2. Enter their email address and click Send invite
  3. They receive an email with a one-click acceptance link
  4. Once accepted, they appear as a team member with full access to recruitment features

Roles

  • Owner — full access including billing, branding, and team management. One per organisation.
  • Member — full access to all recruitment features. Cannot access billing or remove other members.

Seat limits

  • Starter — 2 seats
  • Pro — 5 seats
  • Agency — 15 seats

To add more seats, upgrade your plan in My Profile → Personal tab → Plan & billing.

💳
Upgrading, changing, or cancelling your plan
+

To upgrade or change your plan, go to My Profile → Personal tab → Plan & billing. Select monthly or annual billing, then click the relevant plan button. You'll be taken to a secure checkout page.

Managing an existing subscription

If you are already on a paid plan, a Manage subscription → link appears below the plan grid. This opens the Stripe billing portal where you can update payment details, view invoices, or cancel.

Cancellation

Cancelling keeps your access until the end of your current billing period. After that, your account moves to the Free tier. Note that Free is a one-time 50-scan allowance, not a recurring monthly grant, so a returning Free user does not get a fresh batch of scans on rollover. Nothing is deleted: your jobs, candidates, and screening history are preserved.

Top-up scans

If you need extra scans without changing your plan, top-up packs are available as one-time purchases from My Profile → Personal tab → Plan & billing: 50 scans for $19, 150 scans for $49, or 500 scans for $149. Top-up scans never expire, carry over month to month, and are only used after your plan allowance runs out.

💡

Annual plans are up to 23% cheaper than monthly. You can switch between billing periods when upgrading.

🧾
What Stripe checkout collects for invoices
+

When you upgrade or buy a top-up pack, Stripe Checkout collects a few details on top of your card so your invoices and tax records are correct.

  • Business name. Appears on every invoice. Use the legal entity name your finance team expects.
  • Billing address. Required. Used on invoices and to determine the correct tax treatment for your region.
  • Tax ID. Optional, collected in supported regions (VAT for the EU and UK, GST for several others). Adding it puts your tax number on every invoice and may zero-rate VAT where reverse charge applies.

You can update these details at any time from the Stripe billing portal. Open My Profile → Personal tab → Plan & billing and click Manage subscription →.

🎨
Setting up your agency branding
+

Your agency branding appears on all client-facing and candidate-facing pages — the share link shortlist, the candidate portal, the public job board, and PDF reports. No Aptly branding is shown on any of these pages.

What to set up

  1. Go to My Profile → Company tab
  2. Upload your logo (PNG, JPG, or SVG, max 500KB) under Company logo
  3. Fill in your company name, industry, contact email, phone, website, and address under Company details
  4. Save changes

Branding is applied to your entire organisation — all team members' jobs and outputs use the same logo and details.

🔒
What it means if your account is disabled
+

If your organisation's account has been disabled, you see a full-screen message instead of the app. The message explains what has happened and how to get in touch with us. A Sign out button is the only action available.

Accounts can be disabled for a few reasons, including unpaid billing, a request from the organisation owner, or a violation of our terms.

To restore access, email hello@aptly.pro from the address linked to your Aptly account. We will explain what is needed and reactivate the account once it is resolved.

Your data is preserved while the account is disabled. Jobs, candidates, and screening history are not deleted by the disable action itself.

Client CRM
🏢
Managing clients and contacts
+

The Clients section lets you maintain a list of your hiring companies, their contacts, and the jobs linked to each account — all in one place.

Adding a client

  1. Go to Clients in the main navigation
  2. Click + New client
  3. Enter the company name and any relevant details
  4. Add contacts under the client record — name, role, email, and phone

Linking a client to a job

When creating or editing a job, select the client from the Client dropdown. This links the job to the client record, and all related jobs appear together on the client's page so you can see everything you are running for a company at a glance.

💡

The client context and values you set on a job feed directly into the scoring engine. The more specific your client information, the more accurate the scoring.

Intelligence API
What is the Aptly Intelligence API?
+

The Aptly Intelligence API lets you submit CVs and a job spec programmatically and receive structured scoring results back — no Aptly UI required. It is designed for corporates, ATS platforms, and developers who want to embed CV intelligence directly into their own tools.

How it works

  1. Submit a job spec and up to 200 CVs via a single POST request
  2. Receive a job_id immediately — processing runs in the background
  3. Poll for results via GET, or receive them automatically via webhook when complete
  4. Each candidate result includes a score (0–100), a verdict, match reasons, and gaps

Verdict thresholds

  • Strong shortlist — score 75 and above
  • Borderline — score 50 to 74
  • Do not progress — score below 50

Results are retained for 72 hours after completion, then automatically purged. Full endpoint documentation is available at aptly.pro/api-docs.html →

💡

The Intelligence API is a separate product from the Aptly recruiter platform with its own pricing tiers starting at $199/month. Learn more about the API →

🔑
Requesting API access and managing API keys
+

API access is enabled per organisation by Aptly support. Email hello@aptly.pro to request it and we will set you up.

Once enabled, the API Keys tab appears in My Profile. Until then the tab is hidden and key creation is refused. API keys authenticate your requests using the X-API-Key header. You can have up to 5 active keys per organisation, which is useful for separating environments or teams.

Creating a key

  1. Go to My Profile → API Keys tab
  2. Click Create key and give it a label
  3. Copy the full key immediately. It is shown only once and cannot be retrieved again.
  4. Store it securely (a password manager or secrets vault)

Revoking a key

Click Revoke next to any key in the API Keys tab. Revocation is immediate; any requests using that key will fail instantly. If you lose a key, revoke it and create a new one.

Your full API key is displayed only once at creation. Aptly stores only a hashed version and has no way to show it again. If you lose it, revoke and replace it.

No results for ""

Try a different term, or email us at hello@aptly.pro

Still need help?

Our team is available at hello@aptly.pro — we typically respond within a few hours.

Email us →