Clockify API Documentation
This is the complete API documentation for connecting to the Clockify API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet Clockify: Track time, manage projects, approve timesheets, and analyze team costs. Keep reading to get started.
Quickstart
Before you run your first Clockify request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one Clockify connection — create or choose one in Connections. Note its
connectionId.
Every Clockify action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/clockify/latest/actions/{actionSlug}You need a MindCloud API Key and a Clockify connection. Then call an action such as Download Receipt:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/clockify/latest/actions/download-receipt" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Clockify account that should run the action. MindCloud stores and refreshes the Clockify credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
Clockify actions
All 154 published actions for this Clockify version. Each page documents the endpoint, arguments, and response controls.
- POSTAdd Manager Role to User
- POSTAdd User to Workspace
- PUTAdd Users to Group
- PUTAdd Users to Project
- PUTArchive Expense Category
- PUTChange Invoice Status
- PUTChange Policy Status
- PUTChange Recurring Period
- PUTChange Time Off Request Status
- POSTCopy Scheduled Assignment
- POSTCreate Expense
- POSTCreate Expense Category
- POSTCreate Group
- POSTCreate Holiday
- POSTCreate Invoice
- POSTCreate Invoice Payment
- POSTCreate Project
- POSTCreate Project Task
- POSTCreate Recurring Assignment
- POSTCreate Shared Report
- POSTCreate Time Entry
- POSTCreate Time Off Policy
- POSTCreate Time Off Request
- POSTCreate User Time Entry
- POSTCreate User Time Off Request
- POSTCreate Webhook
- POSTCreate Workspace
- POSTCreate Workspace Client
- POSTCreate Workspace Custom Field
- POSTCreate Workspace Tag
- DELETEDelete Client
- DELETEDelete Custom Field
- DELETEDelete Expense
- DELETEDelete Expense Category
- DELETEDelete Group
- DELETEDelete Holiday
- DELETEDelete Invoice
- DELETEDelete Invoice Payment
- DELETEDelete Policy
- DELETEDelete Project
- DELETEDelete Project Task
- DELETEDelete Recurring Assignment
- DELETEDelete Shared Report
- DELETEDelete Tag
- DELETEDelete Time Off Request
- DELETEDelete User Time Entries
- DELETEDelete Webhook
- DELETEDelete Workspace Time Entry
- GETDownload Receipt
- POSTDuplicate Invoice
- POSTDuplicate Time Entry
- GETExport Invoice
- GETGenerate Attendance Report
- GETGenerate Detailed Report
- GETGenerate Expense Report
- GETGenerate Shared Report
- GETGenerate Summary Report
- PUTGenerate Webhook Token
- GETGenerate Weekly Report
- GETGet Client
- GETGet Current User
- GETGet Expense
- GETGet Filtered Project Totals
- GETGet Invoice
- GETGet Invoice Settings
- GETGet Member Profile
- GETGet Policy Balances
- GETGet Project Task
- GETGet Project Totals
- GETGet Tag
- GETGet Time Off Policy
- GETGet User Balance
- GETGet Webhook
- GETGet Webhook Logs
- GETGet Workspace
- GETGet Workspace Project
- GETGet Workspace Time Entry
- GETGet Workspace User Capacity Total
- GETGet Workspace User Capacity Totals
- GETList Addon Webhooks
- GETList Approval Requests
- GETList Assignments
- GETList Created Entities (Experimental)
- GETList Deleted Entities (Experimental)
- GETList Expense Categories
- GETList Holidays in Period
- GETList In-Progress Time Entries
- GETList Invoice Payments
- GETList My Shared Reports
- GETList Project Custom Fields
- GETList Project Tasks
- GETList Updated Entities (Experimental)
- GETList User Groups
- GETList User Managers
- GETList User Time Entries
- GETList Workspace Clients
- GETList Workspace Custom Fields
- GETList Workspace Expenses
- GETList Workspace Holidays
- GETList Workspace Invoices
- GETList Workspace Policies
- GETList Workspace Projects
- GETList Workspace Tags
- GETList Workspace Users
- GETList Workspace Webhooks
- GETList Workspaces
- PUTMark Time Entries as Invoiced
- PUTPublish Assignments
- DELETERemove Manager Role from User
- DELETERemove Project Custom Field
- DELETERemove User from Group
- PUTReplace Time Entries
- POSTResubmit Entries and Expenses for Approval
- POSTResubmit User Entries and Expenses for Approval
- GETSearch Invoices
- GETSearch Workspace Time Off Requests
- GETSearch Workspace Users
- PUTStop User Running Timer
- POSTSubmit Approval Request
- POSTSubmit User Approval Request
- PUTUpdate Approval Request
- PUTUpdate Balance
- PUTUpdate Expense
- PUTUpdate Expense Category
- PUTUpdate Group
- PUTUpdate Holiday
- PUTUpdate Invoice
- PUTUpdate Invoice Settings
- PUTUpdate Member Profile
- PUTUpdate Policy
- PUTUpdate Project
- PUTUpdate Project Custom Field
- PUTUpdate Project Estimate
- PUTUpdate Project Memberships
- PUTUpdate Project Task
- PUTUpdate Project Template
- PUTUpdate Project User Cost Rate
- PUTUpdate Project User Hourly Rate
- PUTUpdate Recurring Assignment
- PUTUpdate Shared Report
- PUTUpdate Tag
- PUTUpdate Task Cost Rate
- PUTUpdate Task Hourly Rate
- PUTUpdate Time Entry
- PUTUpdate User Cost Rate
- PUTUpdate User Custom Field
- PUTUpdate User Hourly Rate
- PUTUpdate User Status
- PUTUpdate Webhook
- PUTUpdate Workspace Client
- PUTUpdate Workspace Cost Rate
- PUTUpdate Workspace Custom Field
- PUTUpdate Workspace Hourly Rate
- POSTUpload Image
Related apps
More Human Resources apps on the Universal API, behind the same REST shape. Or browse all apps.