FlowmageDocs

Request time off

BetaChanges data

Submits a Clockify time off request for yourself or a colleague.

Settings

SettingWhat it is
ConnectionRequiredThe Clockify connection the step signs in with.
Workspace id overrideLeave empty to use the workspace on the connection. Pick another workspace the same key can reach, or type its id — the List workspaces node gives you the ids.
Policy idRequiredWhich kind of leave this is — the List time off policies node gives you the ids.
User idEmpty files the request for the person the API key belongs to. Filing it for a colleague needs the right role in Clockify.
First dayRequiredtext
Last dayRequiredtext
DaysHow many days to take off the balance. Zero lets Clockify work it out from the dates.
Half a daytrue/false
Which half"FIRST_HALF" or "SECOND_HALF" or "NOT_DEFINED"
Notetext
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `clockify`)
workspaceIdtexta value from the vendor's own list
policyIdtext
userIdtext
startDatetext
endDatetext
daysnumber, by default 0
isHalfDaytrue/false, by default false
halfDayPeriod"FIRST_HALF" or "SECOND_HALF" or "NOT_DEFINED", by default "NOT_DEFINED"used when `isHalfDay` is true
notetext

Output

FieldType
requestIdstring
requestTime off requestobject
Sample output, and the expression for each field
  • request
    • id"r-1"
  • requestId"r-1"

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>",
    "days": 0,
    "endDate": "<last day>",
    "halfDayPeriod": "NOT_DEFINED",
    "isHalfDay": false,
    "note": "",
    "policyId": "<policy id>",
    "startDate": "<first day>",
    "userId": "",
    "workspaceId": ""
  },
  "label": "Request time off",
  "type": "clockify.createTimeOffRequest",
  "version": 1
}