Find candidates
Finds candidates in Recruitee by name, email, tag or CV content.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Recruitee connection the step signs in with. |
| Search | Free text — Recruitee searches names, e-mail addresses, phone numbers, tags, sources, cover letters and CV contents. |
| Filters | Recruitee's own filters_json value. Time filters take Unix timestamps. |
| Sort by | "created_at_desc" or "created_at_asc" or "updated_at_desc" or "updated_at_asc" |
| Candidates per call | 1 to 1,000. Recruitee allows up to 10,000 but one node output cannot carry that. With Fetch every page on, this is the page size. |
| Page | Which page to read when Fetch every page is off. |
| Fetch every page | Pages until Recruitee runs out, and refuses past 10,000 candidates rather than answering a short list. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `recruitee`) |
query | text |
filters | any JSON |
sortBy | "created_at_desc" or "created_at_asc" or "updated_at_desc" or "updated_at_asc", by default "created_at_desc" |
limit | number, by default 60 |
page | number, by default 1 |
returnAll | true/false, by default false |
cursor | text |
Output
| Field | Type |
|---|---|
candidates | array |
candidateCountCandidates in this answer | number |
totalHow many Recruitee found in total | number |
hasMoreMore candidates are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- candidateCount0
- candidates[]
- hasMorefalse
- total0
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"connection": "<connection id>",
"cursor": "",
"limit": 60,
"page": 1,
"query": "",
"returnAll": false,
"sortBy": "created_at_desc"
},
"label": "Find candidates",
"type": "recruitee.findCandidates",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The Recruitee connection the step signs in with. |
| Search | Free text — Recruitee searches names, e-mail addresses, phone numbers, tags, sources, cover letters and CV contents. |
| Filters | Recruitee's own filters_json value. Time filters take Unix timestamps. |
| Sort by | "created_at_desc" or "created_at_asc" or "updated_at_desc" or "updated_at_asc" |
| Candidates per call | 1 to 1,000. Recruitee allows up to 10,000 but one node output cannot carry that. With Fetch every page on, this is the page size. |
| Page | Which page to read when Fetch every page is off. |
| Fetch every page | Pages until Recruitee runs out, and refuses past 10,000 candidates rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `recruitee`) |
query | text |
filters | any JSON |
sortBy | "created_at_desc" or "created_at_asc" or "updated_at_desc" or "updated_at_asc", by default "created_at_desc" |
limit | number, by default 60 |
page | number, by default 1 |
returnAll | true/false, by default false |