Guide to ATS API integrations
Editor's note: This is a series on API-based integrations. Check out Merge if you're looking to add 40+ recruiting integrations with one ATS API.
The recruiting market has changed a lot over the past few years. The recruiting space has had significant innovation and new companies continue to enter the recruiting tech market, from AI-based candidate sourcing to job placement solutions for market verticals. In just the past few years, Gem, SmartRecruiters, Jobandtalent, Workrise, SeekOut, and Handshake have all raised more than $100M.
The demand for new recruiting solutions makes integrations with existing applicant tracking systems (ATS), designed to follow candidate progress through the recruiting process, ever more important. Integrating with ATS systems and powering the boom in recruiting tech software are ATS APIs.
Read on for a guide on everything you need to know about ATS APIs:
- Top ATS APIs - Which ATS’s matter most
- Key concepts - How an ATS works
- Data schemas - How various providers organize candidate and job data
- Use cases - Common ways in which ATS data is used in product integrations
- Getting started - Approaching ATS integrations to your product
What are ATS integrations?
An API integration is the process of connecting two or more applications using an API and letting them share data and functionality with each other. ATS integrations are oftentimes required for recruiting products, because there is so much data that is continuously being updated in various systems and the use case of recruiting requires continuously updated and synced data. Especially because the number of candidates that need to be synced for even a small company could be in the thousands, many products are deemed unusable without long-term integrations.
For example, if there was a sourcing product that didn't integrate with an ATS, after a candidate is sourced, the recruiter would have to manually enter the candidate's name, role, LinkedIn, and other details into the ATS. This would be a huge pain for the recruiter, and be an absolute blocker for adoption.
What are the top ATS APIs?
The applicant tracking system (ATS) landscape is broad, with nearly 10 different ATS’s representing 80% of the market share for mid-market and enterprise recruiting. ATS systems focused on SMBs make up an even larger, more fragmented market. Longstanding ATS systems - IBM, UKG (Ultimate), and Ceridian - have been joined in the 2000s by SaaS-first products such as Taleo, SuccessFactors, Workday, Jobvite, and Cornerstone. The latest crop of ATS systems from the 2010s include Greenhouse, Lever, and SmartRecruiters.
Key applicant tracking concepts
While most ATS concepts are relatively straightforward, there are a few key dimensions along which ATS APIs vary. You’ll want to keep these in mind as you access ATS APIs across the various vendors.
Requisitions, jobs, and postings
Most ATS’s have multiple concepts related to what we think of an ‘open position’.
Typically a requisition is a job template, containing information about the job requirements and hiring process (scorecards, interviews, etc.).
Each requisition may have multiple jobs concurrently or over time, typically one for each person to be hired. In some ATS’s like Lever, a job can be assigned to multiple requisitions when unique requisition IDs are required. Other ATS’s like Greenhouse accomplish this with a single requisition but multiple ‘opening IDs’. Greenhouse calls a requisition a ‘job’ and each opening a ‘job opening’.
For each job, there may be none, one, or multiple job postings that we’d typically expect to see listed on a company’s careers page.
Sourcing leads and prospects
Some ATS systems include sourcing capabilities, where a recruiter will reach out to prospective candidates to inform them of the job opening and encourage them to apply. These prospects are often treated separately in the API. For example, in Greenhouse ‘prospects’ are accessed using the same GET endpoint as ‘candidates’, where they aren’t associated with an application (unlike ‘candidates’). However, ‘prospects’ are created using a distinct POST endpoint from ‘candidates’. Some platforms such as Lever refer to prospects as ‘leads’.
Mapping candidates to their applications
Candidates form the primary data object in an ATS (they are applicants being tracked). Many APIs have distinct concepts for the candidate (demographic info, contact info) and the instance of a candidate applying for a specific job. In the case of Greenhouse these concepts are called ‘candidates’ and ‘applications’, respectively. Lever approaches it differently; it has a ‘contact’ that is associated with multiple ‘opportunities’ (instances of the contact applying).
One further difference, when an ATS is part of a broader HRIS package, is how they treat the workflow from candidate to employee. Workday and SAP, for example, can associate a job requisition (and hence a candidate) with an employee that was hired.
Active and archived candidates
Over time an ATS has a lot, in some cases millions, of applicants that have applied to jobs over time. Which candidates are active, typically the ones you’re interested in, is an important dimension to understand for each API.
ATS API data schemas
Candidates represent individuals who apply or are referred for jobs (or in some cases may be recruiting prospects). This object includes contact information: location, phone numbers, emails, and social profile URLs.
Sensitive demographic information for each candidate is typically stored in an EEOC (named after types of discrimination prohibited by the US Equal Employment Opportunity Commission) object or field, with data about race, gender, veteran status, and disability status. Each candidate may also have a set of Attachments such as resumes, cover letters, or portfolios.
Each candidate is typically associated with one or several Applications for jobs they have applied to. The application object includes the application date/time, rejection date/time and reason, source, and the current stage.
Each application is associated with a Job (aka requisition) that represents an open position a company is looking to fill. The job will typically include the departments it is part of, the Offices where the job will be performed, the hiring manager, recruiters, job description, job code, and the status of the job (open, closed, filled).
Each application also has a set of Interviews that correspond to Job Interview Stages. The Interviews object commonly contains information about interviewers, location of the interview, start and end time, and the status of the interview. Each interview typically contains Scorecards per interviewer with timestamps and the interviewer's recommendation.
Each ATS also keeps track of communication with a candidate. Activities such as notes, emails, and comments can be associated with a variety of ATS objects: candidates, applications, and interviews. Each Activity contains data about the activity type, subject, and body.
Finally, when a candidate’s Application makes it all the way through a successful interview process they receive Offers. The Offers object contains information about when the offer was sent, when the offer closed, the start date, and the offer status.
Top ATS API use cases
Job boards and company directories
Attracting candidates starts with having job listings and company profiles easily accessible. ATS products integrate with job ad platforms, job boards, and company profile sites to sync current job openings.
Examples: Indeed, Talent.com, The Org, ZipRecruiter, Comparably, The Muse, AngelList
Lever exports open jobs to AngelList and then imports the candidate’s details if they’re interested.
Building a candidate pipeline is a critical part of recruiting. Sourcing apps integrate with ATS tools to add candidate data for outreach, recommend candidate matches, coordinate employee referrals, and kick off initial recruiting screens.
Examples: Gem, Teamable, Circular, Dover, Fetcher, Handshake, LinkedIn, Ripplematch
Gem integrates with SmartRecruiters to access existing candidate data and to add new candidates to the ATS.
Interview assessments, scheduling, and expenses
Coordinating interviews is complex and, unsurprisingly, many products help make the interview process more efficient. Video interviewing, virtual skills assessments, scheduling apps, travel and expense management, and surveying tools integrate with ATS products to streamline interviewing.
Examples: Bryq, Codility, HackerRank, TestGorilla, Brighthire, Expensify, Calendly
BreezyHR integrates with HackerRank to perform coding assessments and advance applicants through the hiring process.
Communicating effectively with candidates is key to move applicants through the hiring process. ATS’s integrate with communication apps to streamline email and text messaging and perform analytics on the candidates’ interactions.
Examples: Grayscale, Mixmax
Grayscale integrates with Greenhouse to communicate with candidates via text messages.
Offer screening and signing
During the offer process multiple steps are typically required, including background checks, employment checks, authorization of work (I-9, e-verify), reference checks, and electronic signatures. Syncing offer-stage candidates from an ATS system, and then updating the offer status once the check is complete, automates the hiring workflow.
Examples: Checkr, Equifax, HiPeople, Docusign, AdobeSign
Workday integration with Docusign to sign offer letters and other onboarding docs.
HR and onboarding
Once an offer is accepted, companies want to have a seamless onboarding process. ATS products sync new hire data to HR and payroll systems to kick off employee onboarding.
Examples: Personio, Wurk, Deel, Remote
Teamtailor ATS integration that sends new hires to Personio HR for onboarding.
Recruiting analytics are a powerful way to optimize the hiring process. Common ATS integrations sync open roles, hired roles, and interview metrics to track headcount planning, DEI initiatives, and employee interview training.
ChartHop syncs jobs from Greenhouse to report on headcount and recruiting analytics.
ATS integration benefits
Here are some of the benefits of ATS integrations:
Prevents human errors
Requiring your recruiters or clients to copy and paste information to and from an ATS manually can introduce a host of costly errors.
This can be provisioning employees with the wrong level of access to an application, which, in turn, allows them to access data and actions in that app that’s not meant for them; it can be marking a candidate as rejected when they're actually still in process, which sends them a rejection email accidentally which creates a poor candidate experience; or it can be putting the wrong name for a candidate, which can lead to confusion—and the list goes on.
Since ATS integration streamlines data entry, your employees or clients don’t have to worry about any of the negative outcomes described above.
Provides a great customer experience
By allowing clients to automatically sync candidate data with your product, you can sync candidate and application data on time and without any friction; ensure that every application has the correct stage and notes in your product; set off the appropriate workflows for each candidate; reject or move forward candidates in your product based on the corresponding changes in the client’s ATS, etc.
All of this translates to happier clients that are more engaged in your product and are more likely to renew and spend more on you.
Delivers an improved employee experience
Enabling employees to avoid copying and pasting data between applications not only prevents them from carrying out tedious, mundane work but also lets them focus on tasks they enjoy and are uniquely positioned to tackle. And by letting employees focus on more interesting, strategic work, they can be happier at your organization—making them more productive.
By using a unified API, you can simply build to a single API to offer dozens of customer-facing ATS integrations. This limits the time your developers have to spend on building your integrations and it ensures you’re able to offer all the integrations your clients and prospects need.
In addition, the unified API solution can make the process of managing and performing maintenance on these integrations easy by offering fully-searchable logs and features like automatic issue detection.
Approaches for implementing customer-facing ATS integrations
Now that you know why ATS integrations and the major players and data scehamas, the next question you’re likely asking is how, exactly, you can go about implementing them.
Here are a few options to help guide your evaluation.
In-house development involves assigning your in-house engineering team to build integrations to 3rd-party APIs and to maintain the integrations in an ongoing basis.
There are certainly some benefits to this approach. For instance, it allows you to avoid working with 3rd-parties. In addition, it can prove manageable if you only need to build one integration or the integrations you need to build are relatively shallow in scope.
However, in reality, you’ll likely need to implement and maintain an ever-growing set of robust integrations. Tasking your developers with this would take up most of (if not all of) their time, forcing them to forgo other critical work, such as addressing product bugs or developing key features for your product. In addition, integrations require a lot more time to maintain than to build initially, so you will likely have to hire a team that will be maintaining these integrations in an ongoing basis.
Embedded integration platform as a service (iPaaS)
Embedded iPaaS is a newer option that started in the mid 2010s when iPaaS providers were asked if their solutions could help with product integrations. An embedded iPaaS is a 3rd-party solution that allows you to embed a provider’s iPaaS into your platform.
The platform typically provides multiple deployment options. For instance, you can either build the integrations on behalf of clients or allow them to do so within your platform.
And while embedded iPaaS solutions are a step in the right direction, they don’t fully address the issues presented in in-house development.
They still require a significant amount of technical expertise to use—ultimately forcing your engineers (or your clients) to build and manage the integrations. In addition, you’ll only be able to build one integration at a time, making the prospect of launching a high-volume of integrations quickly all but impossible. Lastly, you will have to maintain these integrations in a new no-code tool where your engineers are less familiar and comfortable with making quick changes.
Unified API solution
Unified APIs are the newest generation of integrations providers, and emerged in popularity in the early 2020s. A unified API platform is a 3rd-party solution that offers a suite of aggregated APIs; each aggregated—or unified—API allows you to connect to multiple 3rd-party solutions in a given software category, such as a CRM.
This type of platform neatly addresses the drawbacks presented in the other options: namely, you can integrate at scale with minimal effort. For instance, Merge lets you connect to more than 40 ATS vendors by simply connecting to its ATS Unified API.
But Merge goes beyond other unified API platforms in a number of other ways.
We offer 7 unified APIs (and growing) to ensure you’re able to scale any type of integration; we provide comprehensive common models across our unified APIs, in addition to features that allow you to access custom fields and objects; we have out-of-the-box integrations management capabilities to help your team assess clients’ integration activities and health as well as assist end-users on resolving their integration issues.
Merge also allows customizability outside of our normalized data, including custom fields, custom objects, pass-through requests, and overriding their existing data models. These features allow you to gain the benefit of one to many, while retaining customizability for enterprise and custom use cases.
Getting started with ATS APIs
In addition to understanding ATS API structures, you’ll also want to keep in mind a few additional topics as you start building:
- API format - REST, SOAP, etc.
- Rate Limits
- Test Accounts
Integrating with multiple ATS systems? Merge unified multiple ATS APIs into one, making it easy to integrate your app with every ATS that your customers use. The Unified ATS API is REST-based, with normalized authentication, pagination, and rate limiting. Merge's dashboard also includes detailed logging and issue detection to make integration management painless. Hundreds of companies use Merge to power their ATS APIs, including Gong, Calendly, and Ripplematch.
To learn more about Merge, you can schedule a demo with one of our integration experts.