Direct Submissions
Submit applications directly via ATS public APIs with pre-flight dry runs and browser automation fallback.
Applying to jobs using LLM jev-ultrafast loops (taking screenshots, analyzing pixels with vision models, clicking coordinates) is computationally expensive and can take over a minute per page.
ATS SDK provides an API-first direct submission engine via submitApplication(). For platforms with open submission APIs, applications are delivered in sub-second HTTP calls with no LLM overhead and deterministic reliability.
Supported Direct Providers
The SDK classifies ATS platforms into two execution tiers:
| Provider | Method | Submission Mechanism |
|---|---|---|
| Greenhouse | Direct API | Multipart form POST to boards-api.greenhouse.io |
| Ashby | Direct API | Structured JSON POST with Base64 resume to api.ashbyhq.com/posting-api |
| Lever | Direct API | Multipart form POST to api.lever.co/v0/postings |
| SmartRecruiters | Direct API | Structured JSON candidate POST to api.smartrecruiters.com/v1/companies |
| Recruitee | Direct API | Multipart form POST to api.recruitee.com/c/offers |
| Workday, iCIMS, Taleo, etc. | Browser Automation | Returns browser_automation_required status with direct apply URL |
You can check if a provider supports direct submissions programmatically using canDirectSubmit(provider):
import { canDirectSubmit } from "ats-sdk";
if (canDirectSubmit("greenhouse")) {
// Direct API submission available
} else {
// Fall back to Playwright / browser automation
}Quick Example
Submit an application directly using createAtsClient:
import { createAtsClient } from "ats-sdk";
const ats = createAtsClient({
companies: ["stripe"],
});
const result = await ats.submitApplication("6141315", {
candidate: {
firstName: "Jane",
lastName: "Doe",
email: "jane.doe@example.com",
phone: "+1-555-0100",
linkedinUrl: "https://linkedin.com/in/janedoe",
},
resume: {
filename: "jane-doe-resume.pdf",
contentType: "application/pdf",
data: "JVBERi0xLjQKJcTl8uXr...", // Base64, Buffer, or Blob
},
answers: [
{
questionId: "custom_question_123",
value: "5 years of TypeScript and Node.js experience.",
},
],
eeo: {
gender: "Female",
veteranStatus: "No",
disabilityStatus: "No",
},
});
if (result.status === "submitted") {
console.log(`Application submitted! ID: ${result.submissionId}`);
}Pre-Flight Dry Runs (dryRun: true)
Before making a live submission to an employer's ATS, pass dryRun: true in options. This runs complete schema validation (checking for required candidate fields and valid resume attachments) without issuing live HTTP requests:
const result = await ats.submitApplication(
"6141315",
{
candidate: {
firstName: "Jane",
lastName: "Doe",
email: "jane.doe@example.com",
},
resume: {
filename: "resume.pdf",
data: resumeBuffer,
},
},
{ dryRun: true }
);
console.log(result.status); // "dry_run"
console.log(result.success); // trueResume Attachment Options
The resume field supports multiple formats, adapting seamlessly to Node.js, Bun, Edge runtime, or browser environments:
// 1. Raw Base64 string
const resumeA = {
filename: "resume.pdf",
contentType: "application/pdf",
data: "JVBERi0xLjQKJcTl8uXr...",
};
// 2. Node / Bun Buffer
const resumeB = {
filename: "resume.pdf",
contentType: "application/pdf",
data: Buffer.from("pdf-data"),
};
// 3. Web standard Blob or File
const resumeC = {
filename: "resume.pdf",
data: new Blob([pdfArrayBuffer], { type: "application/pdf" }),
};Handling Web-Only ATS (Tier 2 Browser Fallback)
When submitting to an enterprise ATS that does not expose a public application API (e.g., Workday or Oracle Taleo), submitApplication() gracefully returns browser_automation_required:
const result = await ats.submitApplication("workday-job-id", submission);
if (result.status === "browser_automation_required") {
console.log("Direct API unavailable for this ATS.");
console.log("Apply URL:", result.applyUrl);
// Hand off to local headless Playwright script:
await fillWithPlaywright(result.applyUrl, submission);
}Deterministic Form Filling
Pair ats.getForm(jobId) with a local headless browser (like Playwright).
Since getForm() provides the exact field names, types, and selectors, your
local browser script can fill the form in a single pass without expensive
vision LLM calls.
Deterministic Job IDs
If you have job IDs generated by AtsClient.getJobs(), they are prefixed deterministically:
gh-stripe-6141315→ Greenhouse (stripe)ashby-openai-12345→ Ashby (openai)lever-figma-abcde→ Lever (figma)sr-canva-78910→ SmartRecruiters (canva)rc-bunq-55443→ Recruitee (bunq)
AtsClient.submitApplication() automatically parses the prefix, resolves the company and adapter, and routes the submission accordingly—even if the company was not explicitly registered in createAtsClient.