FlowmageDocs

Update candidate

BetaChanges data

Changes a Teamtailor candidate's details or relations.

Settings

SettingWhat it is
ConnectionRequiredThe Teamtailor connection the step signs in with.
Candidate idRequiredThe List candidates node gives you the id.
E-mailLeave empty to keep the address Teamtailor has.
First nametext
Last nametext
Phonetext
Pitchtext
CV addressA publicly reachable address Teamtailor downloads and hosts.
LinkedIn addresstext
TagsFilling this in REPLACES the tags the candidate has.
Unsubscribed from mailings"" or "true" or "false"
Department idEmpty leaves it as it is; the word null clears it.
Role idEmpty leaves it as it is; the word null clears it.
Division idEmpty leaves it as it is; the word null clears it.
Location idstext
Region idstext
Anything elseAny other Teamtailor candidate attribute, spelled the way Teamtailor spells it — kebab-case, for example linkedin-uid.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
candidateIdtext
emailtext
firstNametext
lastNametext
phonetext
pitchtext
resumeUrltext
linkedinUrltext
tagstext
unsubscribed"" or "true" or "false"
departmentIdtexta value from the vendor's own list
roleIdtext
divisionIdtext
locationIdstext
regionIdstext
attributesobject (any keys), by default {}

Output

FieldType
candidateIdstring
candidateobject
rawThe untouched JSON:API answerobject
Sample output, and the expression for each field
  • candidate
    • id"c-1"
    • type"candidates"
  • candidateId"c-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": {
    "attributes": {},
    "candidateId": "<candidate id>",
    "connection": "<connection id>",
    "departmentId": "",
    "divisionId": "",
    "email": "",
    "firstName": "",
    "lastName": "",
    "linkedinUrl": "",
    "locationIds": "",
    "phone": "",
    "pitch": "",
    "regionIds": "",
    "resumeUrl": "",
    "roleId": "",
    "tags": "",
    "unsubscribed": ""
  },
  "label": "Update candidate",
  "type": "teamtailor.updateCandidate",
  "version": 1
}