Overview
The Carbone node for n8n allows you to interact with the Carbone API, specifically to add new document templates. This is useful in scenarios where you need to automate the process of uploading template files (such as DOCX or ODT) that will later be used for generating reports. For example, a business could use this node to programmatically manage and update their report templates as part of a larger workflow.
Practical Example:
A company automates its monthly reporting by uploading a new invoice template to Carbone whenever the design changes. The "Add Template" operation lets them upload the latest version directly from an n8n workflow.
Properties
| Name | Type | Meaning |
|---|---|---|
| ID | String | ID of resource to Get, Edit, Delete or add data to. (Hidden for Add Template operation) |
| Binary Property | String | Name of the binary property which contains the data for the file to be uploaded. For Form-Data Multipart, can be provided in the format: "sendKey1:binaryProperty1,sendKey2:binaryProperty2" (default: data). |
Output
- json: Contains the response data from the Carbone API after uploading the template. The structure typically includes metadata about the uploaded template, such as its unique ID and status.
- binary: Not applicable for the "Add Template" operation; only the JSON output is relevant here.
Dependencies
- External Service: Requires access to the Carbone API.
- API Key: You must configure Carbone API credentials in n8n under the name
carboneApi. - n8n Configuration: The input item must contain a binary property (default:
data) with the file to upload.
Troubleshooting
No binary data exists on item!
Cause: The input item does not have a binary property with the file to upload.
Solution: Ensure your workflow provides a file in the specified binary property before this node runs.No binary data property "X" does not exist on item!
Cause: The specified binary property name does not match any property in the input item.
Solution: Double-check the "Binary Property" value and ensure it matches the property containing your file.Invalid API credentials
Cause: Incorrect or missing Carbone API credentials.
Solution: Verify your API key and credential setup in n8n.