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 such as companies, projects, tasks, invoices, and more. Specifically, for the Company - Create operation, it enables creating a new company record in Scoro by sending a structured JSON request body.

Common scenarios where this node is beneficial include automating company data entry from other systems, syncing CRM data into Scoro, or programmatically managing company records without manual input.

For example, you could use this node to create a new company in Scoro whenever a new lead is added in your CRM system, by passing the relevant company details as a JSON object.

Properties

Name Meaning
Request A JSON object representing the nested request body used to create a company in Scoro. This should contain all necessary fields as per Scoro's API specification for creating a company.

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 record, such as its ID, name, and any other metadata returned by the API.

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

Dependencies

  • Requires an active connection to the Scoro API.
  • Needs credentials including:
    • Base URL of the Scoro instance.
    • Company account identifier.
    • An API key or token 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 supported by the node, it will throw an error indicating the operation is unsupported.
  • Invalid JSON in Request: The "Request" property expects valid JSON. Malformed JSON will cause parsing errors. Ensure the JSON is correctly formatted.
  • Authentication Failures: Incorrect or missing API credentials will result in authorization errors. Verify that the API key and base URL are correct.
  • API Errors: If the Scoro API returns an error (e.g., missing required fields, invalid data), the node will pass this error through. Check the response message for details and adjust the request accordingly.

Links and References

  • Scoro API Documentation – For detailed information on the expected structure of the company creation request and available fields.
  • n8n Documentation – For general guidance on using credentials and configuring nodes.

Discussion