FlowmageDocs

Add note or review

BetaChanges data

Writes a note, or a 1–5 review, on a Teamtailor candidate.

Settings

SettingWhat it is
ConnectionRequiredThe Teamtailor connection the step signs in with.
NoteRequiredWhat the recruiters read where they work.
Candidate idRequiredThe List candidates node gives you the id.
Author idRequiredTeamtailor records the note under this person — a note needs an author. The List users node gives you the id.
Rating1 to 5 turns the note into a review. Zero leaves it a plain comment, which is the default.
Application idLinks the note to one application instead of to the candidate in general.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
notetext
candidateIdtext
userIdtext
ratingnumber, by default 0
jobApplicationIdtext

Output

FieldType
noteIdstring
noteobject
rawThe untouched JSON:API answerobject
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
}