Skip to content

Importing a workflow from another builder ​

L2M can import a workflow exported from another visual workflow builder. The export format it understands has top-level nodes[], connections{}, settings and pinData. The import converts every node it can into an L2M node, rebuilds the edges, carries positions and sticky notes over, and hands back a report that tells you exactly what needs a human look before the flow runs.

The converter is pure: it never contacts the source system and never reads credential values. What you get is an ordinary L2M workflow (schemaVersion 1.0.0) that passes graph validation, plus the report.

In the Studio ​

  1. Open the import dialog from any of these places:
    • Import… on the Home page.
    • Import from another builder… in the editor's ⋯ menu.
    • The command palette (⌘K or Ctrl+K).
    • Dropping the .json export straight onto the canvas.
  2. Drop the file, choose it, or paste the JSON. The Studio converts it with a dry run and shows a preview: how many nodes mapped, were approximated or became placeholders, the reason for each, and what you will need to fix afterwards. Nothing is saved yet.
  3. Adjust the workflow name if you like and press Import workflow. The workflow is stored in the active project and opens in the editor.
  4. A checklist docks on the canvas. It lists the credentials to link, variables to fill in, expressions to rewrite and placeholder nodes to replace. Items tick themselves off as you fix them. Clicking a node name selects it on the canvas.
    • Link credentials: pick a stored secret from the list. Every node that used that credential is pointed at it.
    • Tidy layout re-flows the imported graph into stages.
    • Validate saves pending edits and runs graph validation, listing any issues with links to the nodes involved.

The checklist stays with the workflow in your browser until you dismiss it, so you can leave for the Secrets or Variables page and come back. The Import JSON entry also recognises these exports and routes them through the same preview, while L2M's own exports import directly.

Endpoint ​

POST /api/workflows/import/external

Requires the builder role or above, and workflow:write in the target project.

FieldTypeMeaning
sourceobjectThe export JSON as an object.
sourceTextstringThe export JSON as a string (for drag-and-drop uploads). Used when source is absent.
projectIdstringTarget project. Defaults to the folder's project, else default.
folderIdstringTarget folder. Must exist and belong to the target project.
namestringOverrides the workflow name from the export.
dryRunbooleanWhen true, converts and validates but stores nothing.

The response is { workflow, report }. With dryRun: true the workflow is the converted document and nothing is written; otherwise it is the stored workflow (with its final id, project and folder) and the import is recorded in the audit log as workflow.import_external.

A malformed export returns 400 with a message naming what is missing, for example a top-level nodes array or a node without a type.

bash
curl -X POST http://localhost:4000/api/workflows/import/external \
  -H "content-type: application/json" \
  --cookie "ao_session=..." \
  -d '{ "sourceText": "<contents of the export file>", "dryRun": true }'

Run it once with dryRun: true, read the report, then run it again without the flag when you are happy with the mapping.

The three node statuses ​

Every source node appears exactly once in report.nodes with one of three statuses and a reason:

StatusMeaning
mappedThe node has a direct L2M equivalent and its settings were carried over.
approximatedThe node was converted, but something was simplified. The reason says what, for example "only the first sort field was imported".
unsupportedThere is no L2M equivalent yet. The node becomes a placeholder (see below).

report.summary holds the counts, and report.warnings lists workflow-level issues such as dropped connections or an invalid timezone.

Placeholders for unsupported nodes ​

An unsupported node is imported as a disabled noop_node named after the original node, labelled Unsupported: <short type>, the last segment of the source type. Its config keeps the original parameters under importedFrom (parameters, type, version, notes, and the names of any credentials) so nothing is lost when you replace it by hand.

Because the placeholder is a pass-through, the edges into and out of it are kept and the rest of the flow still loads, validates and runs. Attachments that cannot be honoured, for example a tool sub-node with no L2M equivalent, are dropped and listed in report.warnings.

App nodes ​

Nodes for Slack, GitHub, Google Sheets, Postgres, Notion, Jira, Airtable, HubSpot, Salesforce, Stripe, AWS S3, Telegram and Discord are converted onto L2M's connector nodes. The source builder expresses these as a resource and an operation, so the converter dispatches on that pair:

  • A pair L2M covers is mapped, for example posting a Slack message, commenting on a GitHub issue, searching Airtable records or creating a Stripe customer.
  • A pair that is close but loses settings is approximated, and the reason names each dropped setting: a Sheets "append or update" becomes a plain append, a HubSpot "create or update" becomes a create, Slack attachments and message options are dropped, a Postgres select is rewritten as SQL.
  • Any other pair becomes a disabled placeholder whose reason names the resource and operation, so you can see at a glance what to rebuild.

Ids are read from the source's resource pickers: ids are kept, URLs for spreadsheets, Notion databases, Airtable bases and Slack channels are parsed down to the id, and anything referenced only by name is flagged for review. Every string parameter goes through the same expression translation as core nodes.

Triggers (Slack, GitHub, Sheets, Postgres, Stripe, Telegram, Discord) map onto the L2M trigger nodes. The webhook-style ones get a fresh path named after the node and a signing-secret placeholder; the reason tells you to point the external subscription at the new path, and lists any event filters the L2M trigger cannot apply.

Connection details that live inside a source credential rather than on the node, such as a Postgres host, a Jira site URL, a Salesforce instance URL, a Discord webhook URL or an AWS region, are not part of the export. Those nodes import as approximated with empty fields to fill in, and the credential itself still appears in the secrets checklist under a name that says what to provide, for example "Postgres password" or "Slack bot token". A trigger's signing secret and a send node's token get separate entries even when the export lists one credential for both.

Expression translation ​

The common expression subset is translated into L2M template syntax. Translated references resolve against results, which exposes the output of every completed node by id.

text
{{ $json.x }}  or  {{ $input.item.json.x }}        ->  {{results.<previous node id>.x}}
{{ $('Name').item.json.x }}  or  {{ $node["Name"].json.x }}
                                                   ->  {{results.<id of Name>.x}}
{{ $env.KEY }}  or  {{ $vars.KEY }}                ->  {{vars.KEY}}  (plus an empty workflow variable KEY to fill in)
{{ $now }}  or  {{ $now.toISO() }}                 ->  {{ $now.toISOString() }}
{{ $workflow.name }}  /  {{ $execution.id }}       ->  {{workflow.name}}  /  {{execution.id}}

IF, Switch and Filter conditions are compiled into L2M expressions; IF outputs become the true and false handles, Switch outputs become case handles with the extra fallback output on default.

JavaScript code nodes are wrapped in a small compatibility shim that provides $json, $input, $('Name') and item-list return values, so most code runs unchanged. Python code is kept verbatim and marked approximated.

Anything the translator does not understand is left verbatim and listed in report.unresolvedExpressions with the node id, the config path, the original expression and the reason, for example an unknown node name or a date helper with no equivalent. Those templates will render empty until you rewrite them, so treat the list as a checklist.

Secrets checklist ​

Credential references in the export become secretRef placeholders. The import never stores or echoes a credential value: report.secretsToResolve lists each placeholder's secretId, the credential type, the credential name from the export, and the node ids that use it.

After importing:

  1. Create the secret under Secrets if it does not exist yet, then link it from the import checklist in the editor. Through the API, replace the placeholder secretId in each listed node's config with the stored secret's id.
  2. Fill in connection details that lived inside the source credential rather than the node, such as an IMAP host or an Azure OpenAI endpoint. The node's report reason says when this applies.
  3. Set the workflow variables listed in report.variablesToSet.

Coverage ​

The table below is generated from the converter's registration table. Regenerate it after changing the converter:

bash
pnpm --filter @ai-orchestrator/workflow-engine gen:import-coverage

Triggers ​

Source node typeL2M nodeNotes
n8n-nodes-base.manualTriggermanual_triggerDirect mapping.
n8n-nodes-base.webhookwebhook_inputHeader auth becomes bearer_token on the authorization header; other auth modes are dropped.
n8n-nodes-base.scheduleTriggerschedule_triggerInterval rules become cron; only the first rule is kept; second-level intervals become every minute.
n8n-nodes-base.cronschedule_triggerLegacy trigger times become cron; only the first entry is kept.
n8n-nodes-base.intervalschedule_triggerDefaults to hourly when no interval can be read.
@n8n/n8n-nodes-langchain.chatTriggerchat_triggerDirect mapping.
n8n-nodes-base.errorTriggererror_triggerDirect mapping.
n8n-nodes-base.formTriggerform_triggerFile fields become text fields.
n8n-nodes-base.rssFeedReadTriggerrss_triggerPoll times become a poll interval in seconds.
n8n-nodes-base.emailReadImapimap_email_triggerHost, port and user live in the credential and must be filled in after import.

Core nodes ​

Source node typeL2M nodeNotes
n8n-nodes-base.httpRequesthttp_requestQuery parameters are appended to the URL; binary responses become text; auth becomes a secretRef placeholder.
n8n-nodes-base.codecode_nodeJavaScript is wrapped in a compatibility shim; Python is kept verbatim.
n8n-nodes-base.functioncode_nodeLegacy function code is wrapped in the same compatibility shim.
n8n-nodes-base.setset_node'Keep only set fields' is not supported; other fields pass through.
n8n-nodes-base.ifif_nodeConditions compile to one expression; outputs 0 and 1 become the true and false handles.
n8n-nodes-base.switchswitch_nodeSame-field equality rules become cases; other rule sets compile to a routing expression.
n8n-nodes-base.mergemerge_nodeCombine-by-fields keeps the first match field; SQL and position combines become append.
n8n-nodes-base.splitOutsplit_out_nodeOnly the first field to split out is kept.
n8n-nodes-base.itemListssplit_out_nodeLegacy item list node treated as split out.
n8n-nodes-base.aggregateaggregate_nodeCollecting values into an array is approximated with the concatenate operation.
n8n-nodes-base.filterfilter_nodeField-path conditions map directly; expression conditions need review.
n8n-nodes-base.sortsort_nodeOnly the first sort field is kept; custom sort code needs review.
n8n-nodes-base.limitlimit_nodeDirect mapping.
n8n-nodes-base.waitwait_nodeTimer, webhook and specific-time resumes are supported; form resume is approximated as a timer.
n8n-nodes-base.noOpnoop_nodeDirect mapping.
n8n-nodes-base.stopAndErrorstop_and_errorError objects are reduced to message and errorCode.
n8n-nodes-base.executeWorkflowexecute_workflowThe workflow id refers to the source system and must be repointed; per-item mode becomes a single call.
n8n-nodes-base.stickyNotesticky_noteDirect mapping.

AI nodes ​

Source node typeL2M nodeNotes
@n8n/n8n-nodes-langchain.lmChatOpenAiopenai_chat_modelDirect mapping.
@n8n/n8n-nodes-langchain.lmOpenAiopenai_chat_modelCompletion model approximated as a chat model.
@n8n/n8n-nodes-langchain.lmChatAnthropicanthropic_chat_modelDirect mapping.
@n8n/n8n-nodes-langchain.lmChatGoogleGeminigoogle_gemini_chat_modelDirect mapping.
@n8n/n8n-nodes-langchain.lmChatOllamaollama_chat_modelBase URL defaults to the local Ollama endpoint.
@n8n/n8n-nodes-langchain.lmOllamaollama_chat_modelBase URL defaults to the local Ollama endpoint.
@n8n/n8n-nodes-langchain.lmChatAzureOpenAiazure_openai_chat_modelThe endpoint lives in the credential and must be set after import.
@n8n/n8n-nodes-langchain.lmChatOpenRouteropenai_compatible_chat_modelOpenAI-compatible endpoint with the provider's public base URL.
@n8n/n8n-nodes-langchain.lmChatGroqopenai_compatible_chat_modelOpenAI-compatible endpoint with the provider's public base URL.
@n8n/n8n-nodes-langchain.lmChatMistralCloudopenai_compatible_chat_modelOpenAI-compatible endpoint with the provider's public base URL.
@n8n/n8n-nodes-langchain.lmChatDeepSeekopenai_compatible_chat_modelOpenAI-compatible endpoint with the provider's public base URL.
@n8n/n8n-nodes-langchain.lmChatXAiGrokopenai_compatible_chat_modelOpenAI-compatible endpoint with the provider's public base URL.
@n8n/n8n-nodes-langchain.agentagent_orchestratorModel, memory and tool sub-nodes become attachment edges; an attached output parser becomes the next step.
@n8n/n8n-nodes-langchain.memoryBufferWindowlocal_memoryDirect mapping.
@n8n/n8n-nodes-langchain.memoryPostgresChatlocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.memoryRedisChatlocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.memoryMongoDbChatlocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.memoryZeplocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.memoryMotorheadlocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.memoryXatalocal_memoryExternal memory stores are approximated with the local Simple Memory store.
@n8n/n8n-nodes-langchain.mcpClientToolmcp_toolSSE transport becomes HTTP streamable; tool exclusion lists are not supported.
@n8n/n8n-nodes-langchain.outputParserStructuredoutput_parserRuns as a step after the agent; schemas are inferred from example output when no manual schema is given.
@n8n/n8n-nodes-langchain.lmChat*openai_compatible_chat_modelAny other chat model type is approximated as an OpenAI-compatible endpoint with a placeholder base URL.

App nodes ​

Source node typeL2M nodeNotes
n8n-nodes-base.slackslack_send_messageMessage posting maps to a bot-token send; attachments and most message options are dropped; other resources and operations become placeholders.
n8n-nodes-base.slackTriggerslack_triggerEvent and channel filters are not supported; the signing secret becomes a placeholder.
n8n-nodes-base.telegramtelegram_send_messageText messages map directly; keyboards and most options are dropped; other resources and operations become placeholders.
n8n-nodes-base.telegramTriggertelegram_triggerUpdate filters are not supported; the webhook secret token becomes a placeholder.
n8n-nodes-base.discorddiscord_send_messageWebhook sends map with content, username and embeds; bot-token sends and other operations become placeholders.
n8n-nodes-base.discordTriggerdiscord_triggerEvent filters are not supported; the application public key must be set after import.
n8n-nodes-base.githubgithub_actionIssue create/comment/close, file get/create/edit and repository issue listing map to github_action operations; labels, assignees and filters are dropped; other operations become placeholders.
n8n-nodes-base.githubTriggergithub_webhook_triggerEvent filters are not supported; the webhook must be created on the repository by hand.
n8n-nodes-base.jirajira_create_issueIssue creation and JQL search map; the site URL and email live in the credential; other operations become placeholders.
n8n-nodes-base.notionnotion_create_pageDatabase page creation and querying map; simple property types are translated, manual filters and content blocks are dropped; other operations become placeholders.
n8n-nodes-base.googleSheetsgoogle_sheets_readRead, append, append-or-update and update map to the Sheets nodes; row filters and header matching are dropped; sheets picked by gid need the range set; other operations become placeholders.
n8n-nodes-base.googleSheetsTriggergoogle_sheets_triggerPolls the sheet for new rows; row-update events are approximated.
n8n-nodes-base.postgrespostgres_queryExecute-query and select map to a query; the connection details live in the credential; insert, update, upsert and delete become placeholders.
n8n-nodes-base.postgresTriggerpostgres_triggerTable and LISTEN triggers are approximated as a polling query.
n8n-nodes-base.airtableairtable_list_recordsSearch, create and update map to the Airtable nodes; auto-mapped fields are dropped; get, upsert and delete become placeholders.
n8n-nodes-base.awsS3aws_s3_get_objectFile download, upload and listing map to the S3 nodes; the region lives in the credential; binary uploads need the body set; bucket and folder operations become placeholders.
n8n-nodes-base.hubspothubspot_create_contactContact create-or-update becomes a create and contact get maps directly; other resources and operations become placeholders.
n8n-nodes-base.salesforcesalesforce_create_recordRecord creation and SOQL search map; list operations become SOQL; the instance URL lives in the credential; other operations become placeholders.
n8n-nodes-base.stripestripe_create_customerCustomer and charge creation map with metadata; addresses, shipping and payment sources are dropped; other resources and operations become placeholders.
n8n-nodes-base.stripeTriggerstripe_webhook_triggerEvent filters are not supported; the signing secret becomes a placeholder.

Any other source node type is imported as a disabled noop_node placeholder that keeps the original parameters, so the workflow still loads and validates.

This website (not the L2M product) uses Google Analytics, only after you accept cookies. Cookie settings