Set custom field value
BetaChanges data
Writes a Teamtailor custom field value on a candidate or job.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Teamtailor connection the step signs in with. |
| Custom field idRequired | The List custom fields node gives you the id. |
| Owner idRequired | The candidate or job the value belongs to. |
| Belongs to | "candidates" or "jobs" |
| Value | Dates are ISO 8601 (2026-09-22T09:00:00+02:00); a multi-select takes a JSON array of option ids. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `teamtailor`) |
customFieldId | text |
ownerId | text |
ownerType | "candidates" or "jobs", by default "candidates" |
value | text |
Output
| Field | Type |
|---|---|
customFieldValueIdValue id | string |
customFieldValueValue | object |
rawThe untouched JSON:API answer | object |
Sample output, and the expression for each field
- customFieldValue
- id"v-1"
- type"custom-field-values"
- customFieldValueId"v-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": {
"connection": "<connection id>",
"customFieldId": "<custom field id>",
"ownerId": "<owner id>",
"ownerType": "candidates",
"value": ""
},
"label": "Set custom field value",
"type": "teamtailor.setCustomFieldValue",
"version": 1
}