Digitaliso icon

Digitaliso

Consume Digitaliso API.

Overview

The Digitaliso node for n8n allows you to interact with the Digitaliso API, specifically to create new items within your Digitaliso account. The "Create Item" operation sends a POST request to the API to add a new item, using user-defined parameters as the body of the request.

Common scenarios:

  • Automating the creation of items in Digitaliso from other systems (e.g., when a new record is created in a CRM).
  • Integrating Digitaliso with other business tools to streamline data entry.
  • Batch-creating items based on incoming data from various sources.

Practical example:
You could use this node in an n8n workflow that listens for new rows in a Google Sheet and automatically creates corresponding items in Digitaliso, mapping sheet columns to item fields.


Properties

Name Type Meaning
Items String The specific endpoint or resource name in Digitaliso to run the API call on.
Body Parameters Fixed Collection Key-value pairs representing the fields and values to include in the new item.

Details:

  • Items: This is a required string that specifies which Digitaliso resource you are targeting (e.g., "products", "orders").
  • Body Parameters: A collection where each entry has a "Name" (field name) and "Value" (field value) to be sent in the request body. These define the properties of the item being created.

Output

The output will be a JSON object containing the response from the Digitaliso API after creating the item. The structure depends on the API's response, but typically includes the details of the newly created item.

Example output:

{
  "id": 123,
  "name": "Sample Item",
  "created_at": "2024-06-01T12:00:00Z",
  // ...other fields returned by the API
}
  • If the API returns an array, each element will be output as a separate item.
  • In case of error and if "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

  • External Service: Requires access to the Digitaliso API.
  • API Credentials: You must provide a valid API key and company identifier via n8n credentials named digitalisoApi.
  • n8n Configuration: No special configuration beyond setting up the credentials.

Troubleshooting

Common issues:

  • Invalid Credentials: If the API key or company ID is incorrect, authentication will fail. Ensure your credentials are correct in n8n.
  • Missing Required Fields: If required body parameters are not provided, the API may return a validation error.
  • Incorrect Endpoint ("Items") Value: If the "Items" property does not match a valid Digitaliso resource, the API will likely return a 404 or similar error.

Error messages:

  • "401 Unauthorized": Check your API key and company ID.
  • "400 Bad Request": Review the body parameters for missing or invalid fields.
  • "Resource not found": Verify the value entered in the "Items" property.

Links and References

Discussion