Scoro icon

Scoro

Interact with the Scoro API

Overview

This node integrates with the Scoro API to manage various resources, including Time Entries. Specifically, the "Create" operation for the "Time Entry" resource allows users to create new time entry records in Scoro by sending a structured JSON request body. This is useful for automating time tracking workflows, such as logging billable hours or project time entries directly from n8n.

Practical examples include:

  • Automatically creating time entries when tasks are completed in other systems.
  • Logging work hours based on calendar events or project management updates.
  • Integrating time tracking data into billing or reporting workflows.

Properties

Name Meaning
Request A JSON object representing the nested request body used to create a time entry in Scoro.

The "Request" property expects a JSON object that matches the structure required by the Scoro API for creating a time entry. Users provide this JSON to specify details such as the time spent, associated project or task, date, and any notes.

Output

The node outputs JSON data representing the response from the Scoro API after creating the time entry. This typically includes the newly created time entry's details such as its unique ID, timestamps, and any metadata returned by the API.

If the API supports binary data (not indicated here), it would be summarized accordingly, but in this case, the output is purely JSON.

Dependencies

  • Requires an active connection to the Scoro API via an API key credential.
  • The node expects credentials containing at least:
    • Base URL of the Scoro instance.
    • Company account identifier.
    • API key for authentication.
  • These credentials must be configured in n8n before using the node.

Troubleshooting

  • Unsupported Operation Error: If you select an operation-resource combination not implemented, the node throws an error indicating the operation is unsupported. Ensure you use valid combinations like "Create" with "Time Entry".
  • Invalid JSON in Request: Since the "Request" property expects a JSON object, malformed JSON will cause parsing errors. Validate your JSON input carefully.
  • Authentication Failures: Incorrect or missing API credentials will result in authorization errors. Verify your API key and company account ID.
  • API Errors: The Scoro API may return errors if required fields are missing or invalid in the request body. Review the API documentation for required fields and formats.

Links and References

Discussion