Migrate from SmartRecruiters: what moves, scopes, limits
What Shuttio reads from SmartRecruiters, where it lands in Ashby, Lever, Greenhouse, which permissions it needs and why, and what does not move.
Last updated: 20 November 2026
Shuttio connects to SmartRecruiters with a credential your administrator makes in Credential Manager (Settings, Administration, App management, Custom applications, New Credential). The main way is an OAuth client: you paste its Client ID and Client secret, choose the scopes, and no redirect is involved. The fallback is an API key.
Object by object: What objects are supported for SmartRecruiters migrations.
What Shuttio reads and moves
- Jobs: in every status SmartRecruiters has. CREATED arrives as draft, SOURCING, INTERVIEW, OFFER and ON_HOLD as open, FILLED and CANCELLED as closed. Each comes with its job ad, department, location, compensation, properties and hiring team.
- Users, departments, rejection reasons and withdrawal reasons.
- Candidates: read in pages of 100 by cursor. A candidate has one assignment per job, and Shuttio makes one application for each. A person with no assignment, a talent-pool lead, arrives as a candidate with no application.
- Status: the stage is SmartRecruiters' status, one of Lead, New, In review, Interview, Offered or Hired. Rejected, withdrawn and transferred end the application. The status history gives the dated stage history, and a change of sub-status alone does not add a stage event.
- Sub-status: the free text your account defines goes into the application's details, dated, and not into the stage.
- Screening answers: the candidate's answers to the job's questions. Answers to the EEO question are kept apart as EEO answers.
- Messages: become notes under their authors. Only OPEN and EVERYONE messages are written as shared, and every other message stays private.
- Reviews: become feedback. Interviews are read by application, with their time slots and interviewers. Offers come with their fields, status and decision date.
- Attachments: read through the download link, with the by-id path as a second try. The candidate's other files are read once.
Where each thing lands
| SmartRecruiters object | In Ashby | In Lever | In Greenhouse |
|---|---|---|---|
| Candidates | Its own object, or the one you already have with that name | Its own object, or the one you already have with that name | Its own object, or the one you already have with that name |
Notes, tasks, meetings, calls, files, owners and lists depend on the destination. This is the row for SmartRecruiters, generated from the same tables the runner uses:
Into Ashby
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SmartRecruiters | Candidates | Yes | No | No | No | No | Yes | Yes | No |
Into Lever
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SmartRecruiters | Candidates | Yes | No | No | No | No | Yes | Yes | No |
Into Greenhouse
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SmartRecruiters | Candidates | Yes | No | No | No | No | Yes | Yes | No |
In Ashby, Lever and Greenhouse, notes and files move with the candidate; interviews and offers are written as notes, offers as private notes.
Each destination's own article says how its data is written: Ashby, Lever, Greenhouse.
Scopes and why
| What | Why Shuttio needs it |
|---|---|
| An OAuth client (the main way) | Client ID and Client secret from Credential Manager, with the client credentials grant. SmartRecruiters shows the secret once, when you make the credential. You choose the scopes and a system role there. Shuttio gets an access token from it and renews it before it expires, about every 30 minutes. |
| Or an API key | Sent as X-SmartToken. SmartRecruiters gives it full access, and recommends a key only for testing, so Shuttio takes it as the fallback. |
| jobs_read | Jobs and their hiring team. The first read is the job list, and a credential SmartRecruiters refuses there is refused at connect. |
| candidates_read | Candidates, their applications, screening answers and attachments. |
| candidate_status_read | The status history of each application. |
| interviews_read, reviews_read | Interviews, and reviews (scorecard ratings and comments). |
| candidates_offers_read | Offers. |
| users_read, configuration_read | Users, so notes and interviews name people, and departments with the rejection and withdrawal reasons. |
| messages_read | Candidate messages. SmartRecruiters makes this an administrator-only endpoint. |
A credential that lacks a scope but can read jobs still connects. jobs_read, candidates_read, users_read and configuration_read are checked at connect; the scopes for status history, reviews, offers, interviews and messages are checked on the first candidate with a job. The connect step names each missing scope and what is left out because of it. Shuttio sends the credential only to api.smartrecruiters.com; attachment links on other hosts are fetched without it.
What SmartRecruiters' API does not give
- Custom pipelines: the API gives a fixed status and a free-text sub-status, never your own pipeline stages. Shuttio uses the status as the stage because those names are the same in every account, so your sub-statuses are in the details note and are not created as stages.
- Not moved: offer documents, candidate consent records, onboarding status and candidate property values.
- Message visibility: SmartRecruiters' docs define no value list, so only OPEN and EVERYONE count as shared.
- Files: a file over 30 MB is not copied.
Known limits
- Rate limit: SmartRecruiters allows 10 requests a second per credential, 8 at once, and 1 at once on the candidate list. Shuttio waits 150 ms between requests, waits a second when the remaining count reaches 1, and backs off on a 429. After five tries it pauses the run.
- Time: Shuttio makes about ten requests per candidate, so a large account takes hours, and the run pauses when SmartRecruiters asks it to slow down.
Not answered here? Email help@shuttio.com.