SmartRecruiters
Bring new starters, changes and leavers from SmartRecruiters into every system that needs them, with HR approving each change.
31 ways to read, 8 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with SmartRecruiters, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create candidateApproval by rule
- Create job adApproval by rule
- List application property valuesRead
Example flow
- SmartRecruiters · List application property valuesDone
- SmartRecruiters · Create candidateNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches SmartRecruiters.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to SmartRecruiters
- SmartRecruiters's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
SmartRecruiters jobs, job ads, candidates and application status (read and write); hiring teams, positions, offers, interviews, reviews, users, sources and configuration.
SmartRecruiters API docs- Source actions
- 31
- Destination actions
- 8
- Data types
- 26
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Application properties1
- List application property valuesSource
Candidate property values for a candidate's job. Properties whose label suggests pay, tax, bank, ID or health data are omitted.
Application status history1
- List application status historySource
Status and sub-status changes of a candidate's application to a job.
Application status1
- Change application statusDestinationProvider duplicate protectionApproval before production
Sets a candidate's status (and sub-status) on a job, for example IN_REVIEW, INTERVIEW or HIRED.
Applications1
- Get applicationSource
A candidate's application to one job with status, sub-status and source.
Candidate properties1
- List candidate propertiesSource
Candidate custom property definitions with type and availability.
Candidate tags1
- Get candidate tagsSource
Tags on a candidate.
Candidates4
- Create candidateDestinationNot retried automaticallyApproval before production
Creates a candidate in the talent pool or applied to a job.
- Get candidateSource
One candidate with education, experience and assignments.
- List candidatesSourceIncremental
Candidates with primary assignment and status, filterable by job, status, tag or update time.
- Update candidateDestinationProvider duplicate protectionApproval before production
Updates candidate name, email, phone, location or web links.
Departments1
- List departmentsSource
Departments configured in SmartRecruiters.
Hiring processes1
- List hiring processesSource
Hiring processes with their sub-statuses.
Interview types1
- List interview typesSource
Interview type names configured for the company.
Interviews2
- Get interviewSource
One interview.
- List interviewsSource
Interviews scheduled for an application, with timeslots and interviewers.
Job ad postings1
- List job ad publicationsSource
Job boards and career sites where a job ad is or was published.
Job ads4
- Create job adDestinationNot retried automaticallyApproval before production
Creates an unpublished job ad for a job (title, language, location and sections). Publishing is not done here.
- Get job adSource
One job ad.
- List job adsSource
Job ads of a job with sections, language, location and posting status.
- Update job adDestinationProvider duplicate protectionApproval before production
Replaces a job ad's title, language, location and sections.
Job hiring team1
- List job hiring teamSource
Hiring team members and roles for a job.
Job notes1
- Get job noteSource
The internal note of a job.
Job positions1
- List job positionsSource
Positions (headcount) of a job, including those pending approval.
Job properties1
- List job propertiesSource
Job custom property definitions.
Job status1
- Change job statusDestinationProvider duplicate protectionApproval before production
Sets a job's status, for example SOURCING, ON_HOLD, FILLED or CANCELLED.
Jobs4
- Create jobDestinationNot retried automaticallyApproval before production
Creates a job with classification, location, department and job ad sections.
- Get jobSource
One job with classification, hiring process and properties.
- List jobsSourceIncremental
Jobs with status, posting status, department and location, optionally updated after a timestamp.
- Update jobDestinationProvider duplicate protectionApproval before production
Updates title, reference number, target hiring date, department or job properties with a JSON Patch. Changes may trigger job approval.
Offers2
- Get application offerSource
One offer's status (offer properties with compensation are omitted).
- List application offersSource
Offers for a candidate's application (read-only; offer properties with compensation are omitted).
Rejection reasons1
- List rejection reasonsSource
Reasons that can be given when rejecting a candidate.
Reviews2
- Get reviewSource
One review.
- List reviewsSource
Hiring team reviews (rating and comment) of a candidate for a job.
Source types1
- List candidate source typesSource
Candidate source types (for example job boards or referrals) with subtypes.
Sources1
- List candidate sourcesSource
Candidate sources of a type, used to attribute new candidates.
Users2
- Get userSource
One SmartRecruiters user.
- List usersSourceIncremental
SmartRecruiters users with system role and status.
Withdrawal reasons1
- List withdrawal reasonsSource
Reasons that can be given when a candidate withdraws.
Access and limits
- Authentication
- SmartRecruiters API key (X-SmartToken)
- Plans and access
- API access is available to SmartRecruiters customers; an administrator creates API keys. API keys have full access to the company's SmartRecruiters data; use OAuth custom applications for scoped access (not supported here).
- Test environment
- SmartRecruiters provides sandbox companies to customers and partners on request.
- Rate limits
- 10 requests per second for most endpoints and 8 concurrent requests (1 for GET /candidates); HTTP 429 with rate-limit headers when exceeded.
- Pagination
- Cursor pagination with pageId and nextPageId (limit up to 100).
- Provider events
- Webhook subscriptions for job, candidate and application events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Job compensation is not written, and offer properties (which include compensation) are not returned.
- Intentionally excluded: deleting jobs, candidates, job ads, positions or reviews; publishing or unpublishing job ads on job boards; creating or changing interviews and reviews; attachments, screening answers and onboarding status.
- Job ad compensation (advertised pay) is neither returned nor written, and candidate application properties of type CURRENCY or with pay, tax, bank, ID or health labels are omitted.
- Nexra looks candidates up by ID; the candidates.list q search is free text sent in the query string and should not be used with email addresses.
- The Interviews API needs an application ID (from Get application), and the Reviews API needs candidate and job IDs.
- Candidate property value writes are not implemented because the value shape varies by property type.
- Job and candidate creates have no idempotency key; uncertain writes are not repeated automatically.
Developer reference
- Create the SmartRecruiters credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose SmartRecruiters, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/smartrecruiters and the Connections API.