Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Recruiting agency

Apply to jobs for many candidates from one company key: one applicant_id per candidate, batch applications, webhooks, and per-candidate tracking.

Recruiting, staffing, and career-services teams apply for their candidates from one company workspace key. Each candidate becomes an applicant with a permanent applicant_id. Worklittle fills and submits each employer's form with that candidate's own name, email, and resume, and bills your company workspace. You must have each candidate's permission to apply for them.

Install the agent skill

Paste this into your coding agent (Claude Code, Cursor, Codex, and others):

set up worklittle.com/SKILL.md

Setup

1. Create a key in your company workspace on API keys with jobs:read and jobs:apply. A company key never reads your own personal profile. 2. Add a card or credit in Billing. Applications cost $0.20 each. 3. Add an applicant_id column to your candidate table.

Add a candidate

Create the applicant once, without applying yet, with POST /v1/apply/profile and "action": "save".

curl -s -X POST "https://api.worklittle.com/v1/apply/profile" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "save",
    "name": "Jordan Rivera",
    "email": "jordan@example.com",
    "phone": "+1 512 555 0142",
    "city": "Austin", "state": "TX", "country": "US",
    "work_authorization": ["US"], "needs_sponsorship": false,
    "desired_salary": "$85,000+",
    "resume_file": { "filename": "jordan-rivera.pdf", "content_base64": "JVBERi0x..." }
  }'

Store the returned applicant_id on the candidate's record. Worklittle reads the resume into a profile; fields you send override it. Send what employers commonly ask, such as work authorization, sponsorship, salary, and notice period (about_you), so fewer applications stop for questions. Field list: Profile and resumes.

If the email already has an applicant, you get 409 APPLICANT_EXISTS and Worklittle emails the id to the candidate. Ask them for it.

Apply for a candidate

Find jobs with GET /jobs, then apply to up to 10 at once for one candidate.

curl -s -X POST "https://api.worklittle.com/v1/apply" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: jordan-2026-11-11" \
  -d '{
    "job_ids": ["4829105736", "7310582946"],
    "applicant_id": "a1d27c94-6b3e-4f0a-9c58-7e2b1f4d6a90",
    "webhook_url": "https://agency.example.com/hooks/worklittle"
  }'

Each job gets its own result. One job failing never stops the others. Send auto_submit: false if a recruiter should review each application before it is sent.

Track every candidate

| Need | Call |
| --- | --- |
| Live updates | `webhook_url` events: `apply.session.completed`, `apply.session.awaiting_input`, `apply.outcome.interview`, and more |
| One application | `GET /v1/apply/{session_id}` |
| One candidate's pipeline | `GET /v1/applications?applicant_id=...` |
| Profile, applications, and employer emails | `POST /v1/apply/profile` with `{ "action": "get", "applicant_id": "..." }` |

Employer emails (interview invites, replies) go to the candidate's own inbox, and outcome updates from them. Verification codes are read automatically.

Keep candidates current

- Updated resume or details: POST /v1/apply/profile with "action": "save", the applicant_id, and only the changed fields. Never create a second applicant. - Hands-off applying: add "auto_apply": true to the same call and Worklittle keeps applying to new matching jobs for that candidate. Needs the jobs:auto_apply permission on the key. See Apply settings and auto-apply. - Candidate leaves: POST /v1/apply/profile with "action": "delete". Stop running applications first.

Limits and cost

- $0.20 per application, billed to the company workspace. Free when it fails on Worklittle's side or already_applied. - 3 applications per company per 30 days per candidate by default (max_per_company, up to 10). Many applications at one employer read as spam to recruiters. - Daily caps per key and per candidate return 429. See Rate limits. - For high volume or many end users, email [support@worklittle.com](mailto:support@worklittle.com) about a platform key.