List jobs
Lists Teamtailor jobs, published or internal, with their departments.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Teamtailor connection the step signs in with. |
| Status | Teamtailor answers only published jobs unless you say otherwise here. |
| Feed | "public" or "internal" |
| Department id | Picked from the list Teamtailor offers. |
| Division id | text |
| Role id | text |
| Location ids | text |
| Region ids | text |
| Tags | text |
| Remote | "" or "none" or "temporary" or "hybrid" or "fully" |
| Template name | Finds the jobs made from one template. |
| Created from | text |
| Created up to | text |
| Changed from | text |
| Changed up to | text |
| Also fetch | Related records to fetch with each job, comma separated. |
| Sort by | Teamtailor's own order is -pinned,date. A minus in front turns the order around. |
| Jobs per call | 1 to 30 — Teamtailor's own maximum is 30. |
| Fetch every page | Follows Teamtailor's own next-page link, and refuses past 5,000 jobs 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 `teamtailor`) |
status | "published" or "unlisted" or "archived" or "draft" or "scheduled" or "all", by default "published" |
feed | "public" or "internal", by default "public" |
department | texta value from the vendor's own list |
division | text |
role | text |
locations | text |
regions | text |
tags | text |
remoteStatus | "" or "none" or "temporary" or "hybrid" or "fully" |
templateName | text |
createdFrom | text |
createdTo | text |
updatedFrom | text |
updatedTo | text |
include | text, by default "department,locations" |
sort | text |
pageSize | number, by default 30 |
returnAll | true/false, by default false |
cursor | text |
Output
| Field | Type |
|---|---|
itemsJobs | array |
itemCountJobs in this answer | number |
recordCountJobs matching the filter (all pages) | number |
hasMoreMore jobs are waiting behind this page | boolean |
nextUrlTeamtailor's own next-page address | string |
rawThe untouched JSON:API answer | object |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- hasMorefalse
- itemCount0
- items[]
- nextUrl""
- raw
- data[]
- included[]
- linksnull
- metanull
- recordCount0
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>",
"createdFrom": "",
"createdTo": "",
"cursor": "",
"department": "",
"division": "",
"feed": "public",
"include": "department,locations",
"locations": "",
"pageSize": 30,
"regions": "",
"remoteStatus": "",
"returnAll": false,
"role": "",
"sort": "",
"status": "published",
"tags": "",
"templateName": "",
"updatedFrom": "",
"updatedTo": ""
},
"label": "List jobs",
"type": "teamtailor.listJobs",
"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 Teamtailor connection the step signs in with. |
| Status | Teamtailor answers only published jobs unless you say otherwise here. |
| Feed | "public" or "internal" |
| Department id | Picked from the list Teamtailor offers. |
| Division id | text |
| Role id | text |
| Location ids | text |
| Region ids | text |
| Tags | text |
| Remote | "" or "none" or "temporary" or "hybrid" or "fully" |
| Template name | Finds the jobs made from one template. |
| Created from | text |
| Created up to | text |
| Changed from | text |
| Changed up to | text |
| Also fetch | Related records to fetch with each job, comma separated. |
| Sort by | Teamtailor's own order is -pinned,date. A minus in front turns the order around. |
| Jobs per call | 1 to 30 — Teamtailor's own maximum is 30. |
| Fetch every page | Follows Teamtailor's own next-page link, and refuses past 5,000 jobs rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `teamtailor`) |
status | "published" or "unlisted" or "archived" or "draft" or "scheduled" or "all", by default "published" |
feed | "public" or "internal", by default "public" |
department | texta value from the vendor's own list |
division | text |
role | text |
locations | text |
regions | text |
tags | text |
remoteStatus | "" or "none" or "temporary" or "hybrid" or "fully" |
templateName | text |
createdFrom | text |
createdTo | text |
updatedFrom | text |
updatedTo | text |
include | text, by default "department,locations" |
sort | text |
pageSize | number, by default 30 |
returnAll | true/false, by default false |