For the complete documentation index, see llms.txt. This page is also available as Markdown.

n8n Integration

n8n is a workflow automation tool that allows users to connect different applications and services to automate tasks. It provides a way to build complex workflows using a visual editor, integrate APIs, databases, and cloud services to streamline processes such as data synchronization, notifications, and system integrations.

Connecting n8n’s open automation engine with nexos.ai’s models and assistants gives teams instant, secure workflow intelligence. Every interaction uses authenticated API‑key access, ensuring sensitive company data remains safe within nexos.ai while providing full observability and control over API usage.

For example, raw financial data can be analyzed entirely inside a nexos.ai assistant. It processes internal figures, then sends back a single sanitized insight—“Expenses increased 12% from Q2”—to an n8n workflow through a secure API call, triggering automated follow‑ups such as dispatching reports or updating dashboards.

How to connect nexos.ai API and n8n

To connect your nexos.ai API and n8n go through the following steps:

1

Generate an API key

Within workspace, navigate to:

Top-right corner "profile → User profile → Generate API Key

How to generate a personal API key

Management → Teams tab → Select team → Generate API Key

Each team can have its API Key with custom settings: models enabled, fallbacks, etc.

If needed, you can rotate the API Key within API keys tab settings. This will rotate the API Key so the old one is deprecated, and you can change it to a new one.

2

Create a new workflow in n8n

On the homepage of your n8n instance click the orange button labeled "Create Workflow"

Next, in the top left corner name your workflow, additionally you can add tags here, too.

3

Configuring the workflow

This guide uses a chat node as the trigger for the AI Agent, however other nodes can also be used.

Add a trigger node that will start the workflow, then add the AI Agent node and make sure they are connected. Next, add the "OpenAI Chat Model" node.

4

Configuring API credentials

From the "OpenAI Chat Model" node select the "Credential to connect with" dropdown, then "Create new credential". This will open a new window where you can paste your nexos.ai API key and set the API URL.

The API URL is https://api.nexos.ai/v1

Make sure to name your credentials by clicking on the "OpenAI account" text in top right corner.

Save and close the API credential window

5

Selecting a model or assistant

The available models and assistants can be selected by using their unique IDs. The nexos.ai Gateway API provides an endpoint that lists available models and assistants.

Alternatively, you can also select the model from the list drop down.

Model list does not contain personal Assistants.

Once you have the model or assistant ID you can copy and paste it in the AI model node.

6

Adding memory

For some use cases short memory retention is required. In those situations the "Simple Memory" node becomes very useful.

7

Testing

This guide uses a chat node as the main touch point, some nodes are only relevant for this specific example. Other node combinations are also possible.

Try out your workflow to see if the nodes have been configured correctly.

FAQ

Which other integrations are available in nexos.ai Gateway?

nexos.ai Gateway supports integrations with the following coding tools:

Last updated