Clockify integration

Overview

Clockify is a free time tracking tool. This tool provides CRUD operations for clients, projects, tags, tasks, time entries, users, and workspaces via the Clockify REST API v1. Supports 7 resources with operations including create, get, get many, update, and delete. Uses X-Api-Key header authentication.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires Clockify API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Client	client
Project	project
Tag	tag
Task	task
Time Entry	timeEntry
User	user
Workspace	workspace

Operations

Each resource has its own operation list. Pick the resource first, then the operation.

Resource	Operation	Value	Description
Client	Create	create	Create a client in the workspace
Client	Delete	delete	Delete a client by ID
Client	Get	get	Retrieve a single client by ID
Client	Get Many	getAll	List clients in the workspace
Client	Update	update	Update an existing client
Project	Create	create	Create a project in the workspace
Project	Delete	delete	Delete a project by ID
Project	Get	get	Retrieve a single project by ID
Project	Get Many	getAll	List projects in the workspace
Project	Update	update	Update an existing project
Tag	Create	create	Create a tag in the workspace
Tag	Delete	delete	Delete a tag by ID
Tag	Get Many	getAll	List tags in the workspace
Tag	Update	update	Update an existing tag
Task	Create	create	Create a task under a project
Task	Delete	delete	Delete a task by ID
Task	Get	get	Retrieve a single task by ID
Task	Get Many	getAll	List tasks under a project
Task	Update	update	Update an existing task
Time Entry	Create	create	Create a time entry
Time Entry	Delete	delete	Delete a time entry by ID
Time Entry	Get	get	Retrieve a single time entry by ID
Time Entry	Update	update	Update an existing time entry
User	Get Many	getAll	List the users in the workspace
Workspace	Get Many	getAll	List the workspaces you can access

Parameters

Every resource except workspace needs a Workspace ID, so it appears in each subsection below apart from Workspace: Get Many. The Task resource additionally needs a Project ID on every one of its operations.

Client: Create

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Client Name	string	Yes	—	Name of client being created.

Client: Delete

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Client ID	string	No	—	The ID of the client.

Client: Get

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Client ID	string	No	—	The ID of the client.

Client: Get Many

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Optional filters applied to the listing.
— Archived	boolean	No	false	Return archived clients instead of active ones.
— Name	string	No	—	If provided, clients will be filtered by name.
— Sort Order	options	No	—	Direction to sort the results in.
				Options: ASCENDING, DESCENDING

Client: Update

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Client ID	string	No	—	The ID of the client to update.
Name	string	Yes	—	The client name to save. This value is always sent, so supply the current name if you are only changing other fields.
Update Fields	collection	No	{}	Fields to change on the client.
— Address	string	No	—	Address of client being updated.
— Archived	boolean	No	false	Whether the client is archived.

Project: Create

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project Name	string	Yes	—	Name of project being created.
Additional Fields	collection	No	{}	Optional fields to set on the new project.
— Billable	boolean	No	true	Whether time logged to this project is billable.
— Color	string	No	#0000FF	Project color as hex code (e.g., #0000FF).
— Client ID	string	No	—	Client ID to associate with the project. Get from Client > Get Many operation.
— Estimate (estimateUi)	fixedCollection	No	{}	Time estimate for the project.
— — Estimate (estimate)	number	No	0	The estimated amount of time.
— — Type	options	No	AUTO	How the estimate is calculated.
				Options: AUTO, MANUAL
— Is Public	boolean	No	true	Whether the project is visible to everyone in the workspace.
— Note	string	No	—	Note about the project.

Project: Delete

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The ID of the project.

Project: Get

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The ID of the project.

Project: Get Many

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Optional filters and sorting applied to the listing.
— Archived	boolean	No	true	Return archived projects.
— Billable	boolean	No	true	Return only billable projects.
— Client IDs	string	No	—	Comma-separated list of client IDs to filter by.
— Contains Client	boolean	No	false	Whether to return only projects having a client.
— Client Status	options	No	—	Filter projects by client status.
				Options: ACTIVE, ARCHIVED
— Contains User	boolean	No	false	Whether to return only projects having users.
— Is Template	boolean	No	false	Whether to return only template projects.
— Name	string	No	—	Filter projects by name.
— Sort Column	options	No	—	The field to sort results by.
				Options: NAME, CLIENT_NAME, DURATION
— Sort Order	options	No	—	Direction to sort the results in.
				Options: ASCENDING, DESCENDING
— User ID	string	No	—	User ID to filter by. Get from User > Get Many operation.
— User Status	options	No	—	Filter projects by the status of their users.
				Options: ACTIVE, ARCHIVED

Project: Update

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The ID of the project to update.
Update Fields	collection	No	{}	Fields to change on the project.
— Billable	boolean	No	true	Whether time logged to this project is billable.
— Color	string	No	#0000FF	Project color as hex code.
— Client ID	string	No	—	Client ID. Get from Client > Get Many operation.
— Estimate (estimateUi)	fixedCollection	No	{}	Time estimate for the project.
— — Estimate (estimate)	number	No	0	The estimated amount of time.
— — Type	options	No	AUTO	How the estimate is calculated.
				Options: AUTO, MANUAL
— Is Public	boolean	No	false	Whether the project is visible to everyone in the workspace.
— Name	string	No	—	New name for the project.
— Note	string	No	—	Note about the project.

Tag: Create

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Name	string	Yes	—	Name of tag being created.

Tag: Delete

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Tag ID	string	Yes	—	The ID of the tag.

Tag: Get Many

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Optional filters and sorting applied to the listing.
— Archived	boolean	No	true	Return archived tags.
— Name	string	No	—	Filter tags by name.
— Sort Column	options	No	—	The field to sort results by.
				Options: NAME
— Sort Order	options	No	—	Direction to sort the results in.
				Options: ASCENDING, DESCENDING

Tag: Update

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Tag ID	string	Yes	—	The ID of the tag to update.
Update Fields	collection	No	{}	Fields to change on the tag.
— Archived	boolean	No	false	Whether the tag is archived.
— Name	string	No	—	New name for the tag.

Task: Create

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The project ID. Get from Project > Get Many operation.
Task Name	string	Yes	—	Name of task to create.
Additional Fields	collection	No	{}	Optional fields to set on the new task.
— Assignee IDs	string	No	—	Comma-separated user IDs to assign. Get from User > Get Many operation.
— Estimate (estimate)	string	No	—	Estimated time in HH:MM format (e.g., 2:30 for 2 hours and 30 minutes).

Task: Delete

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The project ID. Get from Project > Get Many operation.
Task ID	string	Yes	—	ID of the task.

Task: Get

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The project ID. Get from Project > Get Many operation.
Task ID	string	Yes	—	ID of the task.

Task: Get Many

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The project ID. Get from Project > Get Many operation.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Filters	collection	No	{}	Optional filters and sorting applied to the listing.
— Is Active	boolean	No	false	Return only active tasks.
— Name	string	No	—	Text to match in the task name.
— Sort Column	options	No	NAME	The field to sort results by.
				Options: NAME
— Sort Order	options	No	ASCENDING	Direction to sort the results in.
				Options: ASCENDING, DESCENDING

Task: Update

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Project ID	string	Yes	—	The project ID. Get from Project > Get Many operation.
Task ID	string	Yes	—	ID of task to update.
Update Fields	collection	No	{}	Fields to change on the task.
— Assignee IDs	string	No	—	Comma-separated user IDs to assign.
— Estimate (estimate)	string	No	—	Estimated time in HH:MM format.
— Name	string	No	—	New name for the task.
— Status	options	No	ACTIVE	The task status.
				Options: ACTIVE, DONE

Time Entry: Create

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Start	string	Yes	—	Start date/time for the time entry (ISO 8601 format, e.g., 2024-01-15T09:00:00Z).
Additional Fields	collection	No	{}	Optional fields to set on the new time entry.
— Billable	boolean	No	false	Whether the entry is billable.
— Custom Fields	fixedCollection	No	{}	Custom field values to set on the time entry.
— — Custom Field ID	string	No	—	The ID of the custom field.
— — Value	string	No	—	The value to set.
— Description	string	No	—	Description of the work logged.
— End	string	No	—	End date/time (ISO 8601 format).
— Project ID	string	No	—	Project ID. Get from Project > Get Many operation.
— Tag IDs	string	No	—	Comma-separated tag IDs. Get from Tag > Get Many operation.
— Task ID	string	No	—	ID of the task this entry belongs to.

Time Entry: Delete

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Time Entry ID	string	Yes	—	The ID of the time entry.

Time Entry: Get

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Time Entry ID	string	Yes	—	The ID of the time entry.
Additional Fields	collection	No	{}	Options that change how the entry is returned.
— Consider Duration Format	boolean	No	false	Whether to return duration rounded to minutes or seconds based on workspace settings.
— Hydrated	boolean	No	false	Whether to return project, task, and tags in full (not just IDs).

Time Entry: Update

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Time Entry ID	string	Yes	—	The ID of the time entry to update.
Update Fields	collection	No	{}	Fields to change on the time entry.
— Billable	boolean	No	false	Whether the entry is billable.
— Custom Fields	fixedCollection	No	{}	Custom field values to update.
— — Custom Field ID	string	No	—	The ID of the custom field.
— — Value	string	No	—	The value to set.
— Description	string	No	—	Description of the work logged.
— End	string	No	—	End date/time (ISO 8601 format).
— Project ID	string	No	—	Project ID.
— Start	string	No	—	Start date/time (ISO 8601 format). If not provided, the existing start time is preserved.
— Tag IDs	string	No	—	Comma-separated tag IDs.
— Task ID	string	No	—	ID of the task this entry belongs to.

User: Get Many

Parameter	Type	Required	Default	Description
Workspace ID	string	Yes	—	The workspace ID. Find it in Clockify: Settings > Workspace > scroll to bottom for Workspace ID, or call the Workspace > Get Many operation. (hidden when Resource is workspace)
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Optional filters and sorting applied to the listing.
— Email	string	No	—	Filter users by email address.
— Name	string	No	—	Filter users by name.
— Status	options	No	—	Filter users by status.
				Options: ACTIVE, INACTIVE, PENDING, DECLINED
— Sort Column	options	No	—	The field to sort results by.
				Options: EMAIL, NAME, HOURLYRATE
— Sort Order	options	No	—	Direction to sort the results in.
				Options: ASCENDING, DESCENDING

Workspace: Get Many

Parameter	Type	Required	Default	Description
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

One output item per input item — no operation fans out. Binary data on the input item is forwarded unchanged.

• getAll operations (Client, Project, Tag, Task, User and Workspace Get Many) return an array, and the node puts it on a single output item as results. The incoming item JSON is not carried through on these operations. Use a Split Out node on results when you want one item per record downstream.
• All other operations (create, get, update, delete) return one record, and its fields are merged onto the incoming item JSON at the top level. Fields returned by Clockify overwrite same-named fields already on the item.
• delete returns an empty body, so the output item is the incoming item unchanged.

A Get Many result looks like this:

{
  "results": [
    { "id": "60c0e3ae07e3c41f00000001", "name": "Website Redesign" },
    { "id": "60c0e3ae07e3c41f00000002", "name": "Mobile App" }
  ]
}

Reference the data downstream by expression — {{ $json.results }} after a Get Many, or {{ $json.id }} after a create, get or update.

Example Configuration

Find your workspace ID first — this is the only operation that does not need one:

{
  "type": "clockify",
  "parameters": {
    "resource": "workspace",
    "operation": "getAll",
    "returnAll": true
  }
}

Create a client from an upstream record:

{
  "type": "clockify",
  "parameters": {
    "resource": "client",
    "operation": "create",
    "workspaceId": "60c0e3ae07e3c41f00000000",
    "name": "{{ $json.companyName }}"
  }
}

List active, billable projects sorted by name:

{
  "type": "clockify",
  "parameters": {
    "resource": "project",
    "operation": "getAll",
    "workspaceId": "60c0e3ae07e3c41f00000000",
    "returnAll": false,
    "limit": 25,
    "additionalFields": {
      "archived": false,
      "billable": true,
      "client-status": "ACTIVE",
      "sort-column": "NAME",
      "sort-order": "ASCENDING"
    }
  }
}

Create a task under a project and assign it:

{
  "type": "clockify",
  "parameters": {
    "resource": "task",
    "operation": "create",
    "workspaceId": "60c0e3ae07e3c41f00000000",
    "projectId": "{{ $json.projectId }}",
    "name": "{{ $json.taskName }}",
    "additionalFields": {
      "assigneeIds": "60c0e3ae07e3c41f00000011,60c0e3ae07e3c41f00000012",
      "estimate": "2:30"
    }
  }
}

Log a billable time entry against a project and task:

{
  "type": "clockify",
  "parameters": {
    "resource": "timeEntry",
    "operation": "create",
    "workspaceId": "60c0e3ae07e3c41f00000000",
    "start": "{{ $json.startedAt }}",
    "additionalFields": {
      "billable": true,
      "description": "{{ $json.summary }}",
      "end": "{{ $json.endedAt }}",
      "projectId": "{{ $json.projectId }}",
      "tagIds": "{{ $json.tagId }}",
      "taskId": "{{ $json.taskId }}"
    }
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

Clockify manages clients, projects, tasks, tags and time entries in a Clockify workspace, and lists its users and workspaces. It is the right tool when a workflow must create, update or delete those time-tracking records, fetch a client, project, task or time entry by ID, or list clients, projects, tasks, tags, users or workspaces, rather than another time tracker; a tag cannot be fetched singly and time entries cannot be listed. It returns the affected or fetched records as JSON items, one per record.

Basic CRUD Operations

Most resources support standard CRUD operations. Always include workspaceId except for workspace operations.

Pagination

For getAll operations, use returnAll: false with a limit to paginate results:

{
  "returnAll": false,
  "limit": 50
}

Filtering and Sorting

Use additionalFields for filtering and sorting in getAll operations:

{
  "additionalFields": {
    "archived": false,
    "sort-column": "NAME",
    "sort-order": "ASCENDING"
  }
}

Time Entry Date Formats

Always use ISO 8601 format for dates:

{
  "start": "2024-01-15T09:00:00Z",
  "end": "2024-01-15T17:00:00Z"
}