Clockify
API actions for the Clockify integration.
Clockify
Track time, projects, and workspaces in Clockify using a personal API key.
Create Clockify project
Create a new project in a specified Clockify workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Yes | The ID of the workspace where the project will be created. |
name | string | Yes | The name for the new project. |
client_id | string | No | Optional client ID to associate with the project. |
is_private | boolean | No | Whether the project should be private. If true, only workspace admins and assigned users can see it. |
Response
{
"id": "7b3c4d5e6f7g8h9i0j1k2l3m",
"name": "New Project",
"status": "success"
}Create Clockify time entry
Create a completed time entry with specified start and optional end time in a Clockify workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Yes | The ID of the workspace where the time entry will be created. |
project_id | string | Yes | The ID of the project to associate with the time entry. |
description | string | No | Description for the time entry. |
start | string | Yes | Start time in ISO 8601 format (e.g., '2026-01-28T09:00:00Z'). |
end | string | No | Optional end time in ISO 8601 format. If omitted, the time entry will be running. |
Response
{
"description": "Completed task",
"end": "2026-01-28T10:30:00Z",
"id": "9d5e6f7g8h9i0j1k2l3m4n5o",
"start": "2026-01-28T09:00:00Z",
"status": "success"
}List Clockify projects
Retrieve all projects in a specified Clockify workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Yes | The ID of the workspace to list projects from. |
archived | boolean | No | Filter by archived status. If true, returns only archived projects; if false, returns only active projects. |
Response
{
"count": 1,
"projects": [
{
"archived": false,
"id": "6a2b3c4d5e6f7g8h9i0j1k2l",
"name": "Sample Project"
}
],
"status": "success"
}List Clockify workspaces
Retrieve all workspaces accessible to the authenticated Clockify user.
Response
{
"count": 1,
"status": "success",
"workspaces": [
{
"id": "5f1a2b3c4d5e6f7g8h9i0j1k",
"name": "My Workspace"
}
]
}Start Clockify timer
Start a new time entry (timer) in a specified Clockify workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Yes | The ID of the workspace where the timer will be started. |
description | string | No | Optional description for the time entry. |
project_id | string | No | Optional project ID to associate with the time entry. |
Response
{
"description": "Working on task",
"id": "8c4d5e6f7g8h9i0j1k2l3m4n",
"start": "2026-01-28T10:00:00Z",
"status": "success"
}Stop Clockify timer
Stop the currently running timer for a user in a specified Clockify workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Yes | The ID of the workspace containing the running timer. |
user_id | string | Yes | The ID of the user whose running timer should be stopped. |
Response
{
"end": "2026-01-28T11:30:00Z",
"id": "8c4d5e6f7g8h9i0j1k2l3m4n",
"status": "success"
}