Skip to content

Versio.io Event Umbrella node for n8n

The Versio.io Event Umbrella node makes it very easy to send custom, workflow-releated events from any n8n workflow straight into the Versio.io platform. You can use n8n's automation features to turn workflow issues, status changes, or operational decisions into important events for central monitoring and analysis in Versio.io.

This integration is a powerful tool for achieving the "single pane of glass" view, reinforcing Versio.io's function as your comprehensive umbrella system for event consolidation. Before using the Versio.io Event Umbrella node, you must have the following:

  1. Versio.io environment ID: The specific environment ID on your Versio.io platform.
  2. Versio.io API token: An API token with permissions to write events to the target environment.
  3. n8n instance: A running server instance of n8n.

Using

In order to add the Versio.io node into your workflow and use it as an event sender, go to your n8n workflow and click on the plus sign next to your current node and then type Versio.io. The node will appear and is ready for integration.

Figure: n8n Versio.io Event Umbrella configuration dialog

Setting up credentials

The Versio.io node uses a standard API credential type to connect to your environment.

  1. In your n8n instance, click "Credentials" in the sidebar.
  2. Click "Create Credential" and search for "Versio.io API".
  3. Fill in the specific fields (see following table).
  4. Click "Save". You can now use this credential across your Versio.io Event Umbrella nodes.
Field Name Description Source
Server URL The base URL of your Versio.io instance. Found in your browser when accessing Versio.io. The URL for SaaS is https://live.versio.io
Environment The ID of the environment where the events should be sent. Found in top of the the standard dashboard, the search input field or in the browser URL.
API Token The authentication token for accessing the REST API. Generated your APT token in Versio.io. Goto to Environment settings -> Access management -> API tokens. The role Event processing is required!

n8n credentials window

Figure: Integrate Versio.io Event Umbrella in your n8n workflow

Configuration

The Versio.io node is categorized under the Output group in n8n and is designed to take the results of any upstream node and package them into a standardized Versio.io Event Umbrella payload. You can find Versio.io node in n8n nodes panel

Figure: n8n Versio.io Event Umbrella configuration dialog

Required Parameters

These parameters are mandatory for the node to send a functional event:

Field Name Description Example Value
Source Type Defines the system that originally generated the event. This helps in tracking the data origin. n8n (default)
Trigger A short, descriptive name for what caused the event to fire. HighLoadAlert, DatabaseBackupComplete
Message A detailed, human-readable description of the event. The production server 'web-01' exceeded 90% CPU usage for 5 minutes.
Severity How critical the event is, rated on a scale of 0 (Not critical) to 9 (Extremely critical). 4 (default, typically a warning), 8 (critical error)

Additional Fields (Optional)

You can expand the event payload to provide richer context using the Additional Fields collection:

Field Name Description Usage/Notes
Classification A category for the event, used for filtering and grouping in Versio.io. security vulnerability
Event ID A unique ID. Use this if you need to update or overwrite a previously sent event (for deduplication/resolution logic). ALERT-DB-10042-FAIL
UTC Timestamp The exact time the event occurred. If left blank, Versio.io records the current time of reception.
External ID Link A direct URL to the source of the event (e.g., a link to the original n8n workflow execution or a monitoring dashboard). https://n8n.mycompany.com/workflow/123
External ID Name A label for the External ID Link. n8n Workflow Execution
Raw Event (JSON) A JSON object containing any additional, unstructured data you wish to store, allowing for deep-dive analysis later. Use the Expression Editor to map data from upstream nodes (e.g., {{$json}}).