Add note or review
BetaChanges data
Writes a note, or a 1–5 review, on a Teamtailor candidate.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Teamtailor connection the step signs in with. |
| NoteRequired | What the recruiters read where they work. |
| Candidate idRequired | The List candidates node gives you the id. |
| Author idRequired | Teamtailor records the note under this person — a note needs an author. The List users node gives you the id. |
| Rating | 1 to 5 turns the note into a review. Zero leaves it a plain comment, which is the default. |
| Application id | Links the note to one application instead of to the candidate in general. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `teamtailor`) |
note | text |
candidateId | text |
userId | text |
rating | number, by default 0 |
jobApplicationId | text |
Output
| Field | Type |
|---|---|
noteId | string |
note | object |
rawThe untouched JSON:API answer | object |
Sample output, and the expression for each field
- note
- id"n-1"
- type"notes"
- noteId"n-1"
- raw
- data{}
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": {
"candidateId": "<candidate id>",
"connection": "<connection id>",
"jobApplicationId": "",
"note": "<note>",
"rating": 0,
"userId": "<author id>"
},
"label": "Add note or review",
"type": "teamtailor.createNote",
"version": 1
}