Skip to main content

Run an n8n Workflow

n8n is a workflow automation platform. ConsoleX can call n8n workflows as tools, so the AI can trigger them during a chat or task. n8n workflows can run on n8n Cloud or on your own server.

Changed in October 2026

The ConsoleX tool form changed in October 2026. The HTTP API form no longer has an n8n interface type. Use the built-in n8n tool, or add your workflow as a custom HTTP API tool that calls its webhook, as described below.

Option 1: Use the built-in n8n tool​

The Tools tab in Capabilities has an n8n card under Work and collaboration: "Trigger and manage your n8n workflows."

  1. Click … (More) in the left rail, then Capabilities.
  2. On the n8n card, click Add key and enter the details the dialog asks for.
  3. Turn on the n8n tool in a chat (Tools under the message box) or in a task or agent (Add capabilities).

Work and collaboration tools, including the n8n card with Add key

Option 2: Call a workflow's webhook as a custom tool​

Basic flow​

  1. Build an n8n workflow that starts with a Webhook trigger and ends with Respond to Webhook, returning JSON.
  2. In ConsoleX, add a custom HTTP API tool that calls the workflow's webhook URL.
  3. Turn the tool on in a chat, task or agent so the AI can call it when needed.

Set up the trigger and inputs in n8n​

Start the workflow with a Webhook trigger node and end it with Respond to Webhook. Return the response as JSON, because the response body is what ConsoleX passes back to the model as the tool result.

Optional: add authentication in n8n​

If you want token-based authentication, set Header Auth on the Webhook trigger and create a credential with:

  • Name: Authorization
  • Value: Bearer <your_auth_token>

Use the right webhook URL​

The Test URL works for one-off test calls while you build the workflow. After the workflow is published, use the Production URL, which can be called repeatedly.

Create the tool in ConsoleX​

  1. In Capabilities, on the Tools tab, click Add custom tool, then HTTP API.
  2. In Enter JSON Schema for Tool Definition, describe the inputs your workflow expects. Generate by AI can draft it from a plain description.
  3. Under Invocation Method, choose GET or POST, depending on how your Webhook trigger receives parameters.
  4. Fill in the endpoint details the form asks for, using the webhook URL from n8n. If your workflow checks an auth token, enter that token where the form asks for an API key.
  5. Click Save, then turn the tool on where you need it.

Create a Tool dialog with the JSON Schema editor and GET, POST and Use Mock Data

See Add a custom tool for more on the JSON Schema and invocation methods.

If your n8n setup can expose workflows as an MCP server, you can also connect it with Add an MCP server.

Example workflow​

Here is a sample n8n weather workflow you can save and import for reference:

Weather workflow

Notes​

  1. The tool's JSON Schema must match the inputs your workflow expects, otherwise the model may not call it correctly. Use n8n's execution history to debug calls.
  2. Test with a short chat before you use the tool in a scheduled task.