Agent Careerats-sdk

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:

ProviderMethodSubmission Mechanism
GreenhouseDirect APIMultipart form POST to boards-api.greenhouse.io
AshbyDirect APIStructured JSON POST with Base64 resume to api.ashbyhq.com/posting-api
LeverDirect APIMultipart form POST to api.lever.co/v0/postings
SmartRecruitersDirect APIStructured JSON candidate POST to api.smartrecruiters.com/v1/companies
RecruiteeDirect APIMultipart form POST to api.recruitee.com/c/offers
Workday, iCIMS, Taleo, etc.Browser AutomationReturns browser_automation_required status with direct apply URL

You can check if a provider supports direct submissions programmatically using canDirectSubmit(provider):

check-support.ts
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:

apply.ts
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:

dry-run.ts
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); // true

Resume 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:

fallback.ts
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.

On this page