Create project with the Clockify API
Creates a project in a workspace, optionally for a client. Requires name.
- Identifier
- clockify_create_project
The request
POST https://connect.reportei.com/api/tools/clockify_create_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"workspaceId": "<workspaceId>",
"name": "<name>"
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspaceId | string | Yes | Id of the workspace, from List workspaces or the activeWorkspace of Get current user. |
| name | string | Yes | Name of the project. |
| clientId | string | No | Id of the client, from List clients. |
| billable | boolean | No | True when the time on the project is billable. |
| color | string | No | Color of the project, as # and six hexadecimal digits, such as #03A9F4. |
| isPublic | boolean | No | True to let every member of the workspace track time on it. |
| note | string | No | Notes about the project. |
Supported connections
Your customer connects their Clockify account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
When connecting, your customer also enters {region}: the address of their account on the app's API.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/clockify_create_project. It becomes your agent's tool definition with no conversion.
Other Clockify tools
- Get current userGETReturns the connected user with their id, which the userId arguments take, the ids of the active and default workspaces, the email and settings such as the timezone.
- List workspacesGETLists the workspaces of the connected user, with their ids, names, currencies and rates.
- List usersGETLists the users of a workspace with their ids, names and emails, 50 per page. A page with fewer than 50 users is the last one.
- List clientsGETLists the clients of a workspace, 50 per page. A page with fewer than 50 clients is the last one.
- Create clientPOSTCreates a client in a workspace. Requires name.
- List projectsGETLists the projects of a workspace, archived or not, 50 per page. A page with fewer than 50 projects is the last one.
- List tasksGETLists the tasks of a project, 50 per page. A page with fewer than 50 tasks is the last one.
- List time entriesGETLists the time entries of a user in a workspace, 50 per page. A page with fewer than 50 entries is the last one. With hydrated true, each entry brings its project, task and tags instead of only their ids.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
