Hiring workflows

Import from another hiring tool

Bring jobs, candidates, resumes and notes from Greenhouse, Lever, Workable, Trakstar Hire (Recruiterbox), SmartRecruiters, BambooHR, Zoho Recruit, JazzHR, Recruitee, a CSV or a ZIP (with guides for Workday and iCIMS exports). Nothing is added until you approve it, no candidate is ever emailed, and every import can be undone for 30 days.

How it works

  1. Open Settings → Import and pick where you're coming from.
  2. Connect with a read-only key (or upload a file). Press Test connection to check the key first.
  3. Otter reads everything in the background. You can leave the page; large accounts take a while.
  4. Match their stages to Otter's, then review the list: new people, people already in Otter (merged, never overwritten), duplicates combined, and people with no email or phone.
  5. Approve everyone or only the rows you pick, or skip rows. Jobs are created as needed, within your plan's limits.
  6. See the summary, download the per-person report, and undo if needed.

Imported people are never emailed, and automations don't run on them. Their resumes are read like any new resume: AI reading (within your AI limits), skills, match scores and a profile photo. Running the same import again doesn't create doubles. Undo removes what the import added; anyone your team has worked on since is kept, and the report says why.

Connectors

Verified with docs only: Greenhouse, Lever, Workable, Trakstar Hire, SmartRecruiters, BambooHR, Zoho Recruit, JazzHR and Recruitee were built from each vendor's official API documentation and tested against responses copied from it. They haven't yet been run against a real customer account, so check the review list before approving. CSV and ZIP are tested end to end.

  • Greenhouse: Harvest V3 (OAuth) Client ID and Client Secret with harvest:jobs:list, harvest:candidates:list, harvest:applications:list, harvest:departments:list, harvest:notes:list and harvest:attachments:list.
  • Lever: an API key with read access to Postings, Opportunities, Stages, Archive reasons, Notes and Resumes. US and EU accounts both work.
  • Workable: an API access token with r_jobs and r_candidates, plus your subdomain (acme for acme.workable.com).
  • Trakstar Hire (Recruiterbox): the API key from Settings → Advanced Settings → API Key.
  • SmartRecruiters: an API key (X-SmartToken) with read access to jobs and candidates. Resumes come across; comments don't (the API key can't read them).
  • BambooHR (Hiring): an API key from your name → API Keys, plus your subdomain (acme for acme.bamboohr.com). Openings, applicants, stages and resumes come across; BambooHR's API has no way to read applicant comments, so notes don't.
  • Zoho Recruit: pick your data center (zoho.com, .eu, .in, .com.au, .jp or .com.cn), create a Self Client in the Zoho API Console, and paste its Client ID, Client Secret and a code made with the scope ZohoRecruit.modules.READ. The code works once; Otter keeps only the resulting read-only refresh token, encrypted, while the import runs.
  • JazzHR: the API key from Settings → Integrations. Jobs, applicants, hires, comments and resumes come across. JazzHR's published spec has no field list, so check the review list carefully.
  • Recruitee: a personal API token (Settings → Apps and plugins → Personal API tokens) and your company ID or subdomain.
  • Workday and iCIMS: their APIs need a partner agreement, so Settings → Import shows step-by-step export instructions and takes the CSV (or a ZIP with resumes).

The key is stored encrypted only while the import runs and is deleted when it finishes or is discarded.

CSV and ZIP

  • Candidates: first_name, last_name, email, phone, headline, company, location, tags, job_code, job_title, stage, status, notes
  • Jobs: code, title, location, status, workplace_type, employment_type, department
  • ZIP: one CSV plus the resumes (PDF, Word, RTF, ODT or text), up to 5,000 files. Resumes are matched by a resume_file column, or by the person's email or full name in the file name.

Get in touch with us for support, pricing, feature requests, or anything enterprise: hey@otter.diy