Kizeo Forms icon

Kizeo Forms

Interact with KizoForms API

Overview

This node allows you to download a custom export from Kizeo Forms in its original format or as a PDF. It is useful when you need to programmatically retrieve filled form data that has been exported using a specific export template, for further processing, archiving, or sharing. For example, you might use this node to automatically fetch and store completed reports, certificates, or other documents generated by Kizeo Forms.

Practical scenarios:

  • Automatically saving completed inspection reports as Word or PDF files.
  • Sending customized exports of form submissions to clients or team members.
  • Integrating Kizeo Forms exports into document management workflows.

Properties

Name Meaning
Form Name or ID Select the form whose export you want to download. You can choose from a list or specify an ID using an expression.
Export Name or ID Select the export template to use. The options depend on the selected form. You can choose from a list or specify an ID using an expression.
Export in PDF Whether to download the export as a PDF file (true) or in its original format (such as DOCX) (false).
Data The ID of the data (form submission) to export. This identifies which filled form instance will be exported.

Output

The node outputs binary data representing the exported file. The output structure is:

{
  "json": {},
  "binary": {
    "data": {
      "data": "<base64-encoded file content>",
      "fileName": "<original filename from server>",
      "mimeType": "<MIME type of the file>"
    }
  }
}
  • If Export in PDF is enabled, the file will be a PDF.
  • Otherwise, the file will be in its original export format (e.g., DOCX).

Dependencies

  • Kizeo Forms API: Requires valid API credentials configured in n8n under the name kizeoFormsApi.
  • n8n: No additional configuration required beyond setting up the credentials.

Troubleshooting

Common issues:

  • Invalid Form or Export ID: If the provided Form or Export ID does not exist or is incorrect, the node may return an error indicating resource not found.
  • Missing Credentials: If the Kizeo Forms API credentials are not set up or are invalid, authentication errors will occur.
  • Data Not Found: If the specified Data ID does not correspond to an existing form submission, the export will fail.
  • File Download Issues: If the export template is misconfigured or unavailable, the node may return an error or an empty file.

Error messages and resolutions:

  • "401 Unauthorized": Check your Kizeo Forms API credentials in n8n.
  • "404 Not Found": Verify the Form ID, Export ID, and Data ID are correct and exist in your Kizeo Forms account.
  • "Export template not available": Ensure the export template exists and is published for the selected form.

Links and References

Discussion