n8n

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.

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

1

Generate an API key

Within workspace, navigate to:

Personal API key

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

How to generate a personal API key

Team API key

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.

Make sure to store your API key safely and securely. Never share it with anyone.

Make sure you save your API key - you won't be able to access it again after closing the dialog.

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.

Assistants are only available when using personal API key.

For the model list see the following link - https://docs.nexos.ai/gateway-api#get-v1-models

For user's assistant list see the following link - https://docs.nexos.ai/gateway-api#get-v1-assistants

Model list

Model list does not contain personal Assistants.

Model ID

6

Adding memory

Adding memory is optional and might not be applicable to your workflow.

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.