Kizeo Forms icon

Kizeo Forms

Interact with KizoForms API
Join our community

Actions4

Overview

The Kizeo Forms node with the Form Data resource and GetDataDefinition operation retrieves detailed information (the "data definition") for a specific form entry from the Kizeo Forms platform. This is useful when you need to fetch all data fields and their values for a particular submission in a given form.

Common scenarios:

  • Automating the extraction of submitted form data for further processing or integration.
  • Archiving or analyzing responses from field workers or survey participants.
  • Triggering workflows based on the content of a specific form entry.

Practical example:
Suppose your team uses Kizeo Forms for field inspections. You can use this node to automatically retrieve the full details of a specific inspection report (by its ID) and process or store the results in another system.

Properties

Name Meaning
Form Name or ID Select the form from which to retrieve data, either by choosing from a list or specifying the form's ID using an expression.
Data The unique identifier (ID) of the form entry whose data you want to retrieve.

Output

The output is a JSON object containing all the data fields and their values for the specified form entry. The structure directly reflects the data as stored in Kizeo Forms for that entry.

Example output:

{
  "id": "12345",
  "form_id": "67890",
  "fields": {
    "field1": "value1",
    "field2": "value2"
    // ... more fields as defined in the form
  },
  "created_at": "2024-06-01T12:34:56Z",
  "updated_at": "2024-06-02T09:10:11Z"
  // ... other metadata
}

Note: The actual structure may include additional metadata depending on the form configuration.

Dependencies

  • External Service: Requires access to the Kizeo Forms API.
  • API Key: You must configure valid Kizeo Forms API credentials in n8n under the name kizeoFormsApi.

Troubleshooting

Common issues:

  • Invalid Form or Data ID: If the provided form or data ID does not exist, the node will return an error from the Kizeo Forms API. Double-check IDs or use the dropdowns to select valid entries.
  • Authentication Errors: If the API key is missing or incorrect, you'll receive authentication errors. Ensure your credentials are set up correctly in n8n.
  • Insufficient Permissions: The API user must have permission to access the specified form and data.

Error messages and resolutions:

  • "Not found": The form or data ID does not exist. Verify the IDs.
  • "Unauthorized": Check your API credentials.
  • "Forbidden": Your account lacks access rights to the requested form/data.

Links and References

Discussion