Factorial Integration
Bring Skima Intelligence to Factorial HR
Skima AI delivers explainable AI scores, insights, and seamless collaboration directly into the Factorial ATS. No extra logins, no workflow disruption.
What You'll See in Factorial ATS with Skima AI
When Skima AI integrates with Factorial, your recruiting team gains AI-powered candidate intelligence right within the Factorial HR dashboard.
AI Match Score (0-100) is assigned to each applicant.
Reasons bullets (explain why the candidate matches the JD).
"Skima Screened" Tag for easy sorting and filtering.
Shortlist Collaboration Page for managers (Approve/Skip + optional note).
Application comments that capture manager feedback for the audit trail.
A dynamic top-10 shortlist that updates as new applicants apply to ensure your team always focuses on the best talent first.
Why Factorial HR Recruiting Teams Pick Skima AI
Factorial HR users integrate Skima AI because it enhances their ATS with intelligent match scores and automation without forcing them to switch systems.
Unified Experience
All scores, evidence, and feedback appear directly in Factorial HR's candidate timeline.
Frictionless Collaboration
Generate a shortlist link; Skima AI writes decisions back into Factorial HR.
Real-Time Updates
Webhook-driven scoring ensures instant insights on new or updated applications.
Talent Rediscovery
Resurface past applicants across all job postings for hidden gems.
What Skima AI Writes Back to Factorial ATS
| Writes back to | Field name | Type | Example |
|---|---|---|---|
| Candidate Record | SKIMA Match Score | Number (0–100) | 92 |
| Candidate Record | SKIMA Reasons | Array of strings | ["5 yrs ux design","Figma","User research"] |
| Candidate Tags | SKIMA Screened | Tag | SKIMA Screened |
| Candidate Record | Shortlist URL | URL | https://skima.ai/shortlist/xyz |
| Candidate Record | HM Feedback | Enum | 👍 / 👎 / Maybe |
| Candidate Record | HM Comment | Text | "Strong portfolio but lacks mobile experience" |
Note: Skima AI leverages Factorial HR's webhooks for candidates created, candidate updated, and applications submitted for real-time scoring. If webhooks are unavailable, a safe 5-minute polling mechanism ensures freshness.
How Does the Shortlist Loop Work?
Skima AI streamlines hiring collaboration within Factorial HR ATS by creating a seamless shortlist feedback loop.
Recruiter Generates Shortlist
Skima AI produces a secure shortlist URL and tags it in the candidate timeline.
Manager Gives Feedback
Through the URL, the manager clicks 👍, 👎, or "Maybe" and adds optional comments.
Skima AI Updates Factorial HR
Responses are written back into the candidate's timeline via API PATCH calls.
Recruiter Acts
Recruiters view updated rankings and reasons, then advance top candidates.
The result is transparent collaboration, faster decisions, and a full audit trail within Factorial HR's workflow.
Field Map for Factorial Integration
A clear mapping ensures IT and recruiting teams understand every data exchange between Factorial HR and Skima AI
Skima AI retrieves essential data via Factorial HR's REST API:
-
Jobs Endpoint: Job IDs, titles, descriptions, requirements, department.
-
Candidates Endpoint: Candidate IDs, names, emails, phones, profiles.
-
Applications Endpoint: Application IDs, job ID, candidate ID, status, timestamps.
-
Attachments Endpoint: Resume/CV files for parsing.
-
Historical Data: Past application statuses and interview notes for rediscovery.
After scoring, Skima AI updates Factorial HR via API:
-
PATCH /candidates/{id}: Update custom fields- skima_match_score/ skima_reasons / shortlist_url.
-
POST /candidates/{id}/tags: Add "SKIMA Screened" tag.
-
POST /candidates/{id}/notes: Create timeline entries for feedback and evidence.
-
Optional PATCH /applications/{id}: Move applications to a "Skima Shortlisted" stage.
This bidirectional data sync ensures hiring managers always see real-time AI insights within Factorial HR's natural activity flow
Set Up Your Factorial Integration
Factorial + Skima AI integration is fast, secure, and requires minimal IT effort.
Here are 5 steps to set up your Factorial integration:
In Factorial HR, navigate to Settings → API Keys → Generate a new key with read/write scopes for candidates, applications, jobs, and tags.
Subscribe to the candidate. created, candidate. updated, and application. Submitted events; set the endpoint to Skima AI's webhook URL.
Create skima_match_score (number), skima_reasons (long text), shortlist_url (URL), and the "SKIMA Screened" candidate tag.
Submit test applications; verify scores, reasons, tags, and notes are written back correctly.
Go Live enable on 3–5 pilot roles; review weekly analytics emails and schedule a 15- and 30-day performance check.
Security &
Responsible AI
for Factorial
Integrations
Integrating Skima AI with Factorial HR ATS requires trust and compliance. We keep candidate data secure, make decisions transparent, and put hiring managers in charge
- Data Encryption TLS 1.2+ in transit; AES-256 at rest.
- Role-based access API keys are scoped to only the required endpoints.
- Audit Logs All Skima AI reads/writes are logged in your Factorial HR audit trail.
- Explainability Scores include evidence bullets derived directly from resumes—no black-box decisions.
- Compliance for SOC 2, GDPR, and DPA alignment.
Skima AI integrates explainable AI with strict security measures to ensure your Factorial integrations are compliant, auditable, fair, and protected from bias and discrimination risks.
Customer Snapshot: 30-Day Pilot with Factorial HR ATS
58%
Time-to-screen
2X
Interviews from top-10
+24 NPS
HM Satisfaction
Frequently Asked Questions
Everything you need to know about the Factorial integrations
How does Skima AI connect to Factorial HR?
Skima AI integrates with Factorial HR by authenticating via OAuth2 API keys and subscribing to Factorial HR's webhook events. This combination enables secure, real-time candidate data synchronization and scoring.
What data does Skima AI pull from Factorial HR?
Skima AI fetches job postings, candidate profiles, application details, resume attachments, and historical application records from Factorial HR using its REST API to fuel AI-driven skill extraction and rediscovery.
What data does Skima AI write back to Factorial HR?
Skima AI writes back match scores, detailed reasoning bullets, secure shortlist links, "SKIMA Screened" tags, hiring manager feedback, comments, and optional stage updates into Factorial HR's candidate timeline via API calls.
How long does setup take?
Setting up the Factorial HR integration typically requires 60–90 minutes, including API key creation, webhook configuration, custom field definitions, sandbox testing, and verification of scores, tags, and activity notes.
Are webhooks required for real-time updates?
Webhooks are recommended for instant scoring updates upon candidate or application events. If webhooks aren't available, Skima AI falls back to safe polling every five minutes to maintain up-to-date insights.
Can we control automated stage changes?
Yes—automated stage moves to "Skima Shortlisted" can be toggled per job, ensuring teams retain control over pipeline transitions while optionally leveraging AI-powered workflow advancements and configurations.
Is candidate data secure?
All candidate data is encrypted in transit (TLS 1.2+) and at rest (AES-256). Role-scoped API keys, audit logs, and strict access controls protect privacy and ensure compliance.
How do managers provide feedback?
Hiring managers provide feedback through a secure shortlist link, selecting 👍, 👎, or "Maybe," and adding optional comments. Responses automatically sync back into each candidate's Factorial HR timeline for auditability.
How often do match scores refresh?
Match scores refresh instantly upon webhook events such as new applications or updates. Additionally, Skima AI periodically recalculates scores while job postings remain open to ensure current rankings.
Can Skima AI work with limited API permissions?
Yes—Skima AI supports environments with read-only API access plus note-write permissions, enabling scoring, tagging, and evidence notes without full write scopes or automated stage adjustments.