Skip to main content

JSON Mode

Note: JSON mode is intended for advanced users. If you are working with simple templates, read the Guided Fields documentation first.

JSON mode gives you full control over the data sent to Eledo. Instead of filling fields through the UI groups, you provide a complete JSON payload that matches your template structure.

As long as the JSON is valid and matches your template, the document will be generated.

When to Use JSON Mode​

Use JSON mode when:

  • Your template contains nested objects
  • Your template contains repeatable groups (arrays)
  • You need full structural control
  • Guided Fields do not expose all required attributes

JSON mode supports the entire template structure without limitations.

Step 1 — Enable JSON Input​

In the Eledo node configuration:

  1. Locate the Input selector at the top of the configuration panel
  2. Change it from Guided Fields (default) to JSON
  3. A new field called Payload (JSON) will appear

This is where you will paste your template structure.

Step 2 — Get the Template Structure​

  1. Log in to your Eledo account at https://eledo.online/
  2. Open an existing template or create a new one
  3. In the left-side menu, select API
  4. Locate the section labeled HTTP Request Body
  5. Find the content inside the "file" object

Example:

"file": {
    "Name": "",
    "Surname": "",
    "Hobbies": [
        {
            "Hobby": ""
        }
    ]
}

Copy everything inside the outer braces {} of the file object.

Step 3 — Populate the Payload in n8n​

Paste the copied JSON structure into the Payload (JSON) field in the Eledo node.

Then replace the empty values with real data.

Example:

{
    "Name": "John",
    "Surname": "Doe",
    "Hobbies": [
        {
            "Hobby": "Reading"
        }
    ]
}

Instead of fixed values, you can use n8n expressions to bind dynamic data from previous nodes in your workflow.

Example:

{
    "Name": "{{$json["firstName"]}}",
    "Surname": "{{$json["lastName"]}}"
}

This allows you to map incoming data directly into your template structure.

Validation and Errors​

JSON mode requires valid JSON syntax.

If the payload is malformed, n8n will report an error before the request is sent. Always ensure:

  • Proper quotation marks
  • Correct brackets {} and []
  • Valid comma placement

If your JSON is valid but fields do not match the template, Eledo will ignore unknown attributes and process the rest.

Summary​

JSON mode is the most flexible input method available in the Eledo node.

  • No structural limitations
  • Full support for nested objects
  • Full support for arrays
  • Complete control over data mapping

Use Guided Fields for simplicity. Use JSON mode for precision and advanced workflows.