Skip to content
Nappai Documentation

Holded Team Component

The Holded Team Component lets you work with your Holded team data directly from Nappai.
You can list, create, or get information about employees and their time‑tracking records, all through a simple dashboard interface.

How it Works

When you use the component, Nappai sends a request to the Holded API.
Depending on the Resource you pick (Employees or Employees’ Time‑tracking) and the Operation (List, Create, Get), the component calls the appropriate Holded endpoint.
The response from Holded is returned as a Message that you can feed into other components or use as a tool for an AI agent.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

  • Mapping Mode: Enable mapping mode to process multiple data records in batch.
  • Resource: Choose the type of data you want to work with – either Employees or Employees’ Time-tracking.
  • Operation: Pick what you want to do – List, Create, or Get.
  • Tool Name: The name that will appear to an AI agent when this component is used as a tool.
  • Tool Description: A detailed description of what this tool does, helping the agent decide when to use it.
  • Tools arguments metadata: Defines the arguments that the tool will accept.

Credential
This component requires a Holded Task API credential.

  1. In Nappai’s Credentials section, add a new credential of type Holded Task API and paste your Holded API Key.
  2. In the component, select that credential from the Credential dropdown.
    The API key is stored securely and is not shown in the component’s input list.

Outputs

  • Response: A Message containing the raw response from Holded.
    Use this to inspect data, feed into other components, or display to users.
  • Tool: A Tool object that can be passed to an AI agent.
    When the component is in tool mode, the agent can call it by name and receive the same response.

Usage Example

Below is a simple example that lists all employees in your Holded account. text

  1. Drag the Holded Team Component onto the canvas.
  2. Set Resource to “Employees”.
  3. Set Operation to “List”.
  4. Select the Holded Task API credential you created earlier.
  5. Connect the Response output to a “Print” component to see the list.

If you want to use the component as a tool for an AI agent: text

  1. Set Tool Name to “List Employees”.
  2. Provide a helpful Tool Description such as “Returns a list of all employees in the Holded account.”
  3. Connect the Tool output to the agent’s toolkit.
  • Holded Invoice Component – Manage invoices in Holded.
  • Holded Customer Component – Work with customer data.
  • Holded Project Component – Handle projects and tasks.

Tips and Best Practices

  • Use Mapping Mode when you need to process many employees at once (e.g., bulk updates).
  • Keep the Tool Description concise but informative; this helps the AI choose the right tool.
  • Store your Holded API Key in a credential, never hard‑code it in the component.
  • Test the component with the List operation first to verify connectivity before moving to Create or Get.

Security Considerations

  • The Holded API Key is stored in Nappai’s secure credential store and is never exposed in the component’s UI.
  • Always use the credential feature instead of entering the key directly in the component.
  • If you suspect the key has been compromised, revoke it in Holded and create a new one immediately.