Kizeo Forms icon

Kizeo Forms

Interact with KizoForms API

Overview

The Kizeo Forms node's "Form Data" resource with the "PushData" operation allows you to programmatically submit data to a specific form on the Kizeo Forms platform. This is useful for automating the process of sending form responses, such as logging field reports, submitting survey answers, or pushing any structured data into your organization's forms without manual entry.

Common scenarios:

  • Automatically submitting inspection results from another system.
  • Pushing CRM or ERP data into Kizeo Forms for field staff.
  • Integrating external workflows that need to create new form entries in Kizeo.

Example:
A company receives equipment status updates via email and wants to automatically push these updates into a Kizeo Form for tracking and reporting.


Properties

Name Meaning
Form Name or ID The target form where data will be pushed. You can select from a list or specify an ID using an expression.
User Name or ID The user who will be set as the recipient or owner of the pushed data. Select from a list or specify an ID using an expression.
Fields The collection of fields and their values to push into the form. Each entry includes:
- Field Name or ID: The specific form field to populate (selectable per form).
- Value: The value to assign.

Output

The output is a JSON object containing the response from the Kizeo Forms API after pushing the data. The structure typically includes information about the created form entry, such as its ID and status.

Example output:

[
  {
    "id": 123456,
    "message": "Data successfully pushed",
    "status": "success"
  }
]

Note: The exact fields may vary depending on the Kizeo Forms API response.


Dependencies

  • External Service: Requires access to the Kizeo Forms API.
  • API Key: You must configure valid Kizeo Forms API credentials (kizeoFormsApi) in n8n.
  • n8n Configuration: No special environment variables are needed beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid Form or User ID: If the provided form or user does not exist, the API will return an error. Double-check IDs or use the dropdown selectors.
  • Missing Required Fields: If required fields are omitted, the API may reject the request. Ensure all mandatory form fields are included in the "Fields" property.
  • Permission Errors: The API key used must have permission to push data to the specified form.

Typical error messages:

  • "Form not found": Check the "Form Name or ID" value.
  • "User not found": Verify the "User Name or ID".
  • "Missing required field": Ensure all required fields for the form are provided.

Links and References

Discussion