ClockifyList time entries
Lists one person's Clockify time entries in a date range.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Clockify connection the step signs in with. |
| Workspace id override | Leave 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. The id pickers on this node list from it. |
| User id | Empty means the person the API key belongs to — the List users node gives you an id. |
| Description contains | text |
| From | text |
| To | text |
| Project id | text |
| Task id | text |
| Tag ids | Pick from this node's workspace, or type Clockify tag ids. |
| Only entries with a project | true/false |
| Only entries with a task | true/false |
| Include project, task and tag details | Adds the project, task and tag objects instead of only their ids. |
| Only running entries | true/false |
| Entries per call | 1 to 200. Clockify's own default is 50. |
| Fetch every page | Walks Clockify's pages, and refuses past 5,000 entries rather than answering a short list. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `clockify`) |
workspaceId | texta value from the vendor's own list |
userId | text |
description | text |
start | text |
end | text |
projectId | text |
taskId | text |
tagIds | texta value from the vendor's own list |
projectRequired | true/false, by default false |
taskRequired | true/false, by default false |
hydrated | true/false, by default true |
inProgressOnly | true/false, by default false |
pageSize | number, by default 50 |
returnAll | true/false, by default false |
cursor | text |
Output
| Field | Type |
|---|---|
timeEntries | array |
timeEntryCountTime entries in this answer | number |
hasMoreMore entries are waiting behind this page | boolean |
nextPageThe page to ask for next, or 0 | number |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- hasMorefalse
- nextPage0
- timeEntries[]
- timeEntryCount0
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>",
"cursor": "",
"description": "",
"end": "",
"hydrated": true,
"inProgressOnly": false,
"pageSize": 50,
"projectId": "",
"projectRequired": false,
"returnAll": false,
"start": "",
"tagIds": "",
"taskId": "",
"taskRequired": false,
"userId": "",
"workspaceId": ""
},
"label": "List time entries",
"type": "clockify.listTimeEntries",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The Clockify connection the step signs in with. |
| Workspace id override | Leave 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. The id pickers on this node list from it. |
| User id | Empty means the person the API key belongs to — the List users node gives you an id. |
| Description contains | text |
| From | text |
| To | text |
| Project id | text |
| Task id | text |
| Tag ids | Pick from this node's workspace, or type Clockify tag ids. |
| Only entries with a project | true/false |
| Only entries with a task | true/false |
| Include project, task and tag details | Adds the project, task and tag objects instead of only their ids. |
| Only running entries | true/false |
| Entries per call | 1 to 200. Clockify's own default is 50. |
| Fetch every page | Walks Clockify's pages, and refuses past 5,000 entries rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `clockify`) |
workspaceId | texta value from the vendor's own list |
userId | text |
description | text |
start | text |
end | text |
projectId | text |
taskId | text |
tagIds | texta value from the vendor's own list |
projectRequired | true/false, by default false |
taskRequired | true/false, by default false |
hydrated | true/false, by default true |
inProgressOnly | true/false, by default false |
pageSize | number, by default 50 |
returnAll | true/false, by default false |