Teamdeck icon

Teamdeck

Interact with Teamdeck API for project management and time tracking
Join our community

Actions15

Overview

This node integrates with the Teamdeck API to manage time tracking entries within projects. Specifically, the Time-Entry Create operation allows users to create new time entries for resources assigned to projects. This is useful in scenarios where you want to log work hours or track time spent on specific tasks or projects programmatically.

Practical examples include:

  • Automatically logging time entries from a time-tracking app or form submission.
  • Creating time entries based on calendar events or task completions.
  • Integrating with other project management tools to synchronize time tracking data.

Properties

Name Meaning
Project ID The unique identifier of the Teamdeck project (e.g., "12345") where the time entry will be added.
Resource ID The unique identifier of the resource (person) for whom the time entry is being created.
Start Date The start date and time of the time entry (format: YYYY-MM-DD).
End Date The end date and time of the time entry (format: YYYY-MM-DD).
Minutes Duration of the time entry in minutes (e.g., 60 for 1 hour, 480 for 8 hours).
Description A textual description of the time entry, explaining what the time was spent on.
Add Additional JSON Boolean flag indicating whether to pass through additional custom JSON data from input to output.
Additional JSON Custom JSON data to pass through from input to output if the above flag is enabled.

Output

The node outputs JSON objects representing the created time entry as returned by the Teamdeck API. The output JSON includes all standard fields of a time entry such as IDs, dates, duration, description, and any other metadata provided by the API.

If the "Add Additional JSON" option is enabled, the output JSON will also include an additionalJson field containing the user-provided custom JSON data passed through from the input.

The node does not output binary data.

Example output structure (simplified):

{
  "id": "string",
  "project_id": "string",
  "resource_id": "string",
  "start_date": "YYYY-MM-DD",
  "end_date": "YYYY-MM-DD",
  "minutes": number,
  "description": "string",
  "additionalJson": { /* user-provided JSON if enabled */ }
}

Dependencies

  • Requires an API key credential for authenticating with the Teamdeck API.
  • The node makes HTTP requests to the Teamdeck API endpoint at https://api.teamdeck.io/v1/time-entries.
  • Proper configuration of the API key credential in n8n is necessary for successful authentication.

Troubleshooting

  • Missing Required Fields:
    Errors occur if required fields like start_date, end_date, project_id, resource_id, minutes, or description are missing. Ensure all required inputs are provided.

  • Invalid Date Format:
    Dates must be in the format YYYY-MM-DD. Incorrect formats may cause API errors.

  • API Authentication Errors:
    If the API key is invalid or missing, the node will fail to authenticate. Verify that the API key credential is correctly configured.

  • Unknown Operation or Resource:
    The node throws errors if an unsupported operation or resource is specified. Confirm that the resource is set to "time-entries" and operation to "create".

  • Empty Update Fields (for update operations):
    Although not applicable here, similar operations require at least one field to update; otherwise, an error is thrown.

  • Handling API Response Errors:
    The node captures API errors and can continue execution if "Continue On Fail" is enabled, returning error details in the output.

Links and References

Discussion