Scoro icon

Scoro

Interact with the Scoro API

Overview

This node integrates with the Scoro API, allowing users to perform various operations on different Scoro resources. Specifically, for the Company - Create operation, it enables creating a new company record in Scoro by sending a structured JSON request body. This is useful in scenarios where you want to automate company data entry or synchronize company information from other systems into Scoro.

Practical examples include:

  • Automatically adding new client companies when they are created in a CRM.
  • Bulk importing company data from external databases or spreadsheets.
  • Creating companies as part of a larger workflow that manages projects, invoices, or tasks related to those companies.

Properties

Name Meaning
Request A JSON object representing the nested request body used to create a company in Scoro. The user must provide the full structure expected by the Scoro API for company creation.

Output

The node outputs JSON data representing the response from the Scoro API after attempting to create the company. This typically includes details of the newly created company such as its ID, name, and any other metadata returned by the API.

If the API supports binary data (not indicated here), the node would handle it accordingly, but for this operation, 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

  • Common issues:
    • Invalid or incomplete JSON in the "Request" property can cause the API call to fail.
    • Missing or incorrect API credentials will result in authentication errors.
    • Unsupported operations or resources will throw an error indicating the operation is not supported.
  • Error messages:
    • "Operation 'create' for resource 'company' is not supported." — indicates a misconfiguration or unsupported combination.
    • Authentication failures usually return HTTP 401 or 403 errors; verify API key and base URL.
    • JSON parsing errors if the input JSON is malformed; ensure valid JSON syntax.

Links and References

Discussion