Overview
This node integrates with the Phacet API to manage spreadsheet-like data and files. Specifically, for the File Upload operation, it allows users to upload PDF files stored in binary form within n8n workflows directly to Phacet's file storage.
Typical use cases include:
- Automating the upload of PDF documents generated or collected during a workflow into Phacet for further processing or record keeping.
- Integrating document management by linking uploaded PDFs to rows or other entities managed in Phacet.
- Streamlining workflows that require storing or sharing PDF files via Phacet’s platform.
For example, after generating a PDF report in a previous node, you can use this node to upload that PDF to Phacet, making it accessible within your Phacet environment.
Properties
| Name | Meaning |
|---|---|
| Input Binary Field | The name of the binary property in the input data that contains the PDF file to upload. |
| Original Filename | Optional original filename for the uploaded PDF. If not provided, the binary data filename is used. |
Output
The node outputs JSON data representing the uploaded file's metadata returned from the Phacet API. The output includes:
id: The unique identifier of the uploaded file in Phacet.filename: The filename used for the upload (either provided or derived).originalFilename: Same asfilename, reflecting the original or fallback filename.- Additional fields returned by the Phacet API related to the uploaded file.
The output is paired with the corresponding input item index to maintain traceability.
No binary data is output by this node; it only uploads binary data received as input.
Dependencies
- Requires an active connection to the Phacet API using an API key or token configured in n8n credentials.
- Uses the
form-datalibrary internally to format the multipart/form-data request for file upload. - The node expects the input binary data to be a valid PDF file.
Troubleshooting
Error: Only PDF files are supported. File "filename" is not a PDF.
This error occurs if the file extension of the input binary data is not.pdf. Ensure the binary data you provide is a PDF file and that the filename ends with.pdf.Missing binary data or incorrect binary property name.
If the specified binary property does not exist or contains no data, the node will fail. Verify the binary property name matches exactly the field containing the PDF binary data.Authentication errors with Phacet API.
Make sure the API credential is correctly set up and has sufficient permissions to upload files.HTTP or network errors.
Check network connectivity and Phacet API availability.
Links and References
- Phacet API Documentation (for detailed API endpoints and authentication)
- n8n Expressions (to dynamically specify parameters like filenames)
- FormData npm package (used internally for file uploads)