Skip to content

Holded Projects Component

Holded Projects Component connects your flow to the projects module of your Holded account. With a single component you can work with your projects, with each project’s tasks, and with the time the team logs against them.

It is useful when projects come out of another process, for example an accepted quote, or when you want time logged without anyone having to open Holded.

When to use it

  • A customer accepts a quote and you want to create their project in Holded with its first tasks.
  • You want a weekly report with the time logged against each project.
  • An AI agent receives work reports by chat and logs the time against the right project.
  • A project is cancelled and you want to delete it from Holded.

Configuration

You need a Holded Task API credential with your Holded account’s API key. See Credentials.

FieldWhat it does
Credential (required)The Holded Task API credential used to access your account.
ResourceThe kind of data you work with: Projects, Tasks or Time Tracking. Default: Projects.
OperationWhat you do with that data. The list changes with the chosen Resource. See Resources and operations.

When you choose the resource and the operation, the component shows only the fields that operation needs. All of them are required unless stated otherwise.

Resources and operations

Projects

OperationWhat it doesFields
ListReturns all projects.
CreateCreates a project.Project Name
GetReturns one project.Project ID
UpdateRenames a project.Project ID, Project Name
DeleteDeletes a project.Project ID

Tasks

OperationWhat it doesFields
ListReturns all tasks.
CreateCreates a task in a project.Project Id, Task Name
GetReturns one task.Task ID
DeleteDeletes a task.Task ID

Time Tracking (logged time)

OperationWhat it doesFields
Get Project TimesReturns all the time entries of a project.Project ID
Create Project TimeLogs a user’s time against a project and, if you want, one of its tasks.User ID, Project ID, Task ID (optional), Duration
Get Project TimeReturns one time entry.Project ID, Time Tracking ID
Update Project TimeChanges the duration of a time entry.Project ID, Time Tracking ID, Duration
Delete Project TimeDeletes a time entry.Project ID, Time Tracking ID

Output

The Response output returns Holded’s answer as text: the details of the item you worked with, the list of items for the operations that list, or a confirmation for those that delete.

You can connect the result to an agent so it can interpret it, or to a component that extracts the details you need. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

An agency wants to create the project in Holded as soon as the customer accepts the quote.

  1. The acceptance reaches the flow with the customer’s name.
  2. Add Holded Projects Component with the Projects resource and the Create operation, and in Project Name write Website followed by the customer’s name.
  3. Add a second Holded Projects Component with the Tasks resource and the Create operation.
  4. In Project Id enter the project ID returned by the first one and in Task Name Kick-off meeting.