LingvaNex integration

Overview

LingvaNex is a machine translation API that supports translation between 100+ languages. This tool sends text to the LingvaNex B2B Translation API and returns translated text. It supports auto-detection of the source language, HTML translation mode for preserving markup, and customizable platform identifiers.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires LingvaNex API credentials. See the Credentials Guide for setup instructions.

Operations

Operation	Value	Description
Translate	translate	Translate text to a target language

Parameters

Parameter	Type	Required	Default	Description
Text	string	Yes	—	The input text to translate. Supports expressions like {{ $json.body }}. (shown when Operation is translate)
Translate To	string	Yes	—	The target language code (e.g., “en_GB”, “fr_FR”, “de_DE”). Use the LingvaNex /getLanguages endpoint or see https://cloud.google.com/translate/docs/languages for language codes. Supports expressions. (shown when Operation is translate)
Additional Options	collection	No	{}	Optional settings that customize the translation request. (shown when Operation is translate)
— From	string	No	—	The source language code (e.g., “en_GB”, “fr_FR”). If not set, auto-detection is enabled. Supports expressions.
— Platform	string	No	api	The platform identifier for the API request.
— Translate Mode	string	No	—	Set to “html” to translate and preserve HTML structure. Leave empty for plain text translation.
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

One output item per input item. The LingvaNex translation response is merged into the item JSON at the top level, so the incoming fields remain addressable alongside the translation result. Binary data is forwarded.

The response body is passed through as the API returns it — the field carrying the translated text is whatever the LingvaNex /translate endpoint names it. Inspect one run’s output to confirm the exact key before wiring downstream expressions.

Example Configuration

Translate a field on the item into French, letting LingvaNex detect the source language:

{
  "type": "lingvanex",
  "parameters": {
    "operation": "translate",
    "text": "{{ $json.message }}",
    "translateTo": "fr_FR"
  }
}

State the source language explicitly instead of relying on detection:

{
  "type": "lingvanex",
  "parameters": {
    "operation": "translate",
    "text": "{{ $json.message }}",
    "translateTo": "de_DE",
    "options": {
      "from": "en_US"
    }
  }
}

Translate an HTML fragment and keep its markup intact:

{
  "type": "lingvanex",
  "parameters": {
    "operation": "translate",
    "text": "{{ $json.htmlBody }}",
    "translateTo": "es_ES",
    "options": {
      "from": "en_US",
      "translateMode": "html"
    },
    "maxConcurrency": 5
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

This tool translates text between languages using the LingvaNex service. It is ideal when a direct text translation is needed, especially if the source language needs to be auto-detected or HTML content requires preservation. It produces the translated text in the specified target language.

• Language codes are locale-shaped. LingvaNex expects codes like en_GB, fr_FR and de_DE rather than bare two-letter codes.
• Leave From empty to auto-detect. Only set it when you already know the source language and want to rule out a misdetection.
• HTML content needs Translate Mode. Without html, markup in the input is treated as ordinary text.
• Options is a collection. from, platform and translateMode nest under the options key — they are not top-level parameters.